survey-react 1.9.55 → 1.9.56

package/survey.react.d.ts

@@ -1,5 +1,5 @@
 /*
-* Type definition for Survey JavaScript library for React v1.9.55
+* Type definition for Survey JavaScript library for React v1.9.56
 * Copyright (c) 2015-2022 Devsoft Baltic OÜ  - https://surveyjs.io/
 * License: MIT (http://www.opensource.org/licenses/mit-license.php)
 */
@@ -260,6 +260,17 @@ export interface IConditionObject {
   question: Question;
   context?: Question;
 }
+export interface IQuestionPlainData {
+  name: string | number;
+  title: string;
+  value: any;
+  displayValue: any;
+  isNode: boolean;
+  isComment?: boolean;
+  questionType?: string;
+  data?: any;
+  getString: (val: any) => string;
+}
 export interface IMatrixColumnOwner extends ILocalizableOwner {
   getRequiredText(): string;
   hasChoices(): boolean;
@@ -1835,6 +1846,7 @@ export declare class CalculatedValue extends Base {
 *   titleName: "title", // Specifies which field contains display texts for choice values.
 *   imageLinkName: "imageUrl", // Specifies which field contains image URLs. Used in Image Picker questions.
 *   // Path to the array of choices. Specify `path` only if the array of choices is nested within the object returned by the service.
+*   // The following path separators are allowed: semicolon `;`, comma `,`.
 *   path: "myNestedArray"
 * }
 * ```
@@ -1892,7 +1904,7 @@ export declare class ChoicesRestful extends Base {
   get url(): string;
   set url(val: string);
   /*
-  * Path to the array of choices.
+  * Path to the array of choices. The following path separators are allowed: semicolon `;`, comma `,`.
   * 
   * Specify this property only if the array of choices is nested within the object returned by the service. For example, the service returns the following object:
   * 
@@ -2012,14 +2024,19 @@ export declare class DragDropCore<T> extends Base {
 }
 export declare class DropdownListModel extends Base {
   constructor(question: Question, onSelectionChanged?: (item: IAction, ...params: any) => void);
+  minPageSize: any;
+  loadingItemHeight: any;
   _popupModel: any;
   focusFirstInputSelector: string;
   itemsSettings: any;
+  isRunningLoadQuestionChoices: boolean;
   protected listModel: ListModel;
   protected popupCssClasses: string;
+  protected popupRecalculatePosition(isResetHeight: boolean): void;
   protected onHidePopup(): void;
   protected getAvailableItems(): Array<Action>;
   protected createListModel(): ListModel;
+  protected updateAfterListModelCreated(model: ListModel): void;
   protected resetFilterString(): void;
   protected onSetFilterString(): void;
   setInputHasValue(newValue: boolean): void;
@@ -2801,11 +2818,11 @@ export declare class PopupModel<T = any> extends Base {
   displayMode: "popup" | "overlay";
   positionMode: any;
   onVisibilityChanged: EventBase<PopupModel<any>>;
-  onTargetModified: EventBase<Base>;
+  onRecalculatePosition: EventBase<Base>;
   get isVisible(): boolean;
   set isVisible(val: boolean);
   toggleVisibility(): void;
-  targetModified(): void;
+  recalculatePosition(isResetHeight: boolean): void;
 }
 /*
 * A Model for a survey running in the Popup Window.
@@ -2868,6 +2885,8 @@ export declare class PopupSurveyModel extends Base {
   get cssBody(): string;
   get cssHeaderRoot(): string;
   get cssHeaderTitle(): string;
+  get renderedWidth(): string;
+  width: string;
   protected createSurvey(jsonObj: any): SurveyModel;
   protected onSurveyComplete(): void;
 }
@@ -2905,6 +2924,7 @@ export declare class QuestionMatrixDropdownRenderedTable extends Base {
   isRequireReset(): boolean;
   get headerRow(): QuestionMatrixDropdownRenderedRow;
   get footerRow(): QuestionMatrixDropdownRenderedRow;
+  get allowRowsDragAndDrop(): boolean;
   protected build(): void;
   updateShowTableAndAddRow(): void;
   onAddedRow(): void;
@@ -3476,7 +3496,6 @@ export declare class DropdownMultiSelectListModel extends DropdownListModel {
   closeOnSelect: boolean;
   protected override: any;
   createListModel(): MultiSelectListModel;
-  protected onSetFilterString(): void;
   selectAllItems(): void;
   selectNoneItem(): void;
   selectItem(id: string): void;
@@ -3562,6 +3581,7 @@ export declare class ListModel extends ActionContainer {
   onSelectionChanged: (item: Action, ...params: any) => void;
   allowSelection: boolean;
   listContainerHtmlElement: any;
+  loadingIndicatorValue: Action;
   searchEnabled: boolean;
   showFilter: boolean;
   isExpanded: boolean;
@@ -3575,6 +3595,7 @@ export declare class ListModel extends ActionContainer {
   scrollHandler: (e?: any) => void;
   isItemVisible(item: Action): boolean;
   get visibleItems(): any;
+  setItems(items: any, sortByVisibleIndex?: boolean): void;
   protected onSet(): void;
   protected getDefaultCssClasses(): any;
   protected updateItemActiveState(): void;
@@ -3587,6 +3608,8 @@ export declare class ListModel extends ActionContainer {
   get filterStringPlaceholder(): string;
   get emptyMessage(): string;
   get scrollableContainer(): any;
+  get loadingText(): string;
+  get loadingIndicator(): Action;
   goToItems(event: any): void;
   onMouseMove(event: any): void;
   onKeyDown(event: any): void;
@@ -3670,6 +3693,7 @@ export declare class PopupDropdownViewModel extends PopupBaseViewModel {
   popupDirection: string;
   pointerTarget: IPosition;
   updateOnShowing(): void;
+  updatePosition(isResetHeight: boolean, isDelayUpdating?: boolean): void;
   updateOnHiding(): void;
 }
 export declare class PopupModalViewModel extends PopupBaseViewModel {
@@ -3927,7 +3951,7 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
   getRenderer(name: string): string;
   getRendererContext(locStr: LocalizableString): any;
   getProcessedText(text: string): string;
-  protected getUseDisplayValuesInTitle(): boolean;
+  protected getUseDisplayValuesInDynamicTexts(): boolean;
   protected removeSelfFromList(list: any): void;
   protected get textProcessor(): ITextProcessor;
   protected getProcessedHtml(html: string): string;
@@ -5201,7 +5225,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   * 
   * If you want to skip empty answers, pass an object with the `includeEmpty` property set to `false`.
   */
-  getPlainData(options?: any): any;
+  getPlainData(options?: any): Array<IQuestionPlainData>;
   getFilteredValues(): any;
   getFilteredProperties(): any;
   getDataValueCore(valuesHash: any, key: string): any;
@@ -6656,15 +6680,23 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
   set visible(val: boolean);
   protected onVisibleChanged(): void;
   /*
-  * Specifies whether to use display names for question values interpolated in the title. To interpolate question values, use curly brackets (`{}`).
-  * 
-  * This property is useful when interpolated question values have both the `value` and `text` properties.
+  * Specifies whether to use display names for question values in placeholders.
   * 
   * Default value: `true`
+  * 
+  * This property applies to questions whose values are defined as objects with the `value` and `text` properties (for example, [choice items](https://surveyjs.io/form-library/documentation/questionradiogroupmodel#choices) in Radiogroup, Checkbox, and Dropdown questions).
+  * 
+  * You can use question values as placeholders in the following places:
+  * 
+  * - Survey element titles and descriptions
+  * - The [`expression`](https://surveyjs.io/form-library/documentation/questionexpressionmodel#expression) property of the [Expression](https://surveyjs.io/form-library/documentation/questionexpressionmodel) question
+  * - The [`html`](https://surveyjs.io/form-library/documentation/questionhtmlmodel#html) property of the [HTML](https://surveyjs.io/form-library/documentation/questionhtmlmodel) question
+  * 
+  * To use a question value as a placeholder, specify the question `name` in curly brackets: `{questionName}`. Refer to the following help topic for more information: [Dynamic Texts - Question Values](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#question-values).
   */
-  get useDisplayValuesInTitle(): boolean;
-  set useDisplayValuesInTitle(val: boolean);
-  protected getUseDisplayValuesInTitle(): boolean;
+  get useDisplayValuesInDynamicTexts(): boolean;
+  set useDisplayValuesInDynamicTexts(val: boolean);
+  protected getUseDisplayValuesInDynamicTexts(): boolean;
   /*
   * A Boolean expression. If it evaluates to `false`, this question becomes hidden.
   * 
@@ -7019,7 +7051,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
   * 
   * Pass an object with the `includeEmpty` property set to `false` if you want to skip empty answers.
   */
-  getPlainData(options?: any): any;
+  getPlainData(options?: any): IQuestionPlainData;
   /*
   * A correct answer to this question. Specify this property if you want to [create a quiz](https://surveyjs.io/form-library/documentation/design-survey-create-a-quiz).
   */
@@ -7869,7 +7901,7 @@ export declare class QuestionFileModel extends Question {
   protected loadPreview(newValue: any): void;
   protected onCheckForErrors(errors: any, isOnValueChanged: boolean): void;
   protected stateChanged(state: string): void;
-  getPlainData(options?: any): any;
+  getPlainData(options?: any): IQuestionPlainData;
   supportComment(): boolean;
   getChooseFileCss(): string;
   getReadOnlyFileCss(): string;
@@ -7979,7 +8011,9 @@ export declare class QuestionMatrixBaseModel<TRow, TColumn> extends Question {
   alternateRows: boolean;
 }
 /*
-* A Model for a multiple text question.
+* A class that describes the Multiple Text question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-multipletext/ (linkStyle))
 */
 export declare class QuestionMultipleTextModel extends Question implements IMultipleTextData, IPanel {
   constructor(name: string);
@@ -7993,12 +8027,12 @@ export declare class QuestionMultipleTextModel extends Question implements IMult
   setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
   onSurveyValueChanged(newValue: any): void;
   /*
-  * The list of input items.
+  * An array of `MultipleTextItemModel` objects that represent input items.
   */
   get items(): any;
   set items(val: any);
   /*
-  * Add a new text item.
+  * Adds a new input item.
   */
   addItem(name: string, title?: string): MultipleTextItemModel;
   getItemByName(name: string): MultipleTextItemModel;
@@ -8007,18 +8041,17 @@ export declare class QuestionMultipleTextModel extends Question implements IMult
   locStrsChanged(): void;
   supportGoNextPageAutomatic(): boolean;
   /*
-  * The number of columns. Items are rendred in one line if the value is 0.
+  * The number of columns used to arrange input items. Accepts the following values: 1, 2, 3, 4, 5.
+  * 
+  * Default value: 1
   */
   get colCount(): number;
   set colCount(val: number);
   /*
-  * The default text input size.
+  * A value passed on to the [`size`](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/size) attribute of the underlying `<input>` elements.
   */
   get itemSize(): number;
   set itemSize(val: number);
-  /*
-  * Returns the list of rendered rows.
-  */
   getRows(): Array<any>;
   isMultipleItemValueChanging: boolean;
   protected onValueChanged(): void;
@@ -8348,7 +8381,7 @@ export declare class QuestionPanelDynamicModel extends Question implements IQues
   isSetPanelItemData: any;
   setPanelItemData(item: ISurveyData, name: string, val: any): void;
   getRootData(): ISurveyData;
-  getPlainData(options?: any): any;
+  getPlainData(options?: any): IQuestionPlainData;
   updateElementCss(reNew?: boolean): void;
   get progressText(): string;
   get progress(): string;
@@ -8372,28 +8405,49 @@ export declare class QuestionPanelDynamicModel extends Question implements IQues
   updateFooterActionsCallback: any;
 }
 /*
-* A Model for a rating question.
+* A class that describes the Rating question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-rating/ (linkStyle))
 */
 export declare class QuestionRatingModel extends Question {
   constructor(name: string);
   endLoadingFromJson(): void;
   /*
-  * The list of rate items. Every item has value and text. If text is empty, the value is rendered. The item text supports markdown. If it is empty the array is generated by using rateMin, rateMax and rateStep properties.
+  * A list of rate values.
+  * 
+  * 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 `rateValues` property to an array of numbers, for example, `[ 3, 6, 10 ]`. These values are both saved in survey results and used as display text.
+  * 
+  * If you do not specify the `rateValues` property, rate values are generated automatically based upon the `rateMin`, `rateMax`, and `rateStep` property values.
   */
   get rateValues(): any;
   set rateValues(val: any);
   /*
-  * This property is used to generate rate values if rateValues array is empty. It is the first value in the rating. The default value is 1.
+  * Specifies the first rate value in the generated sequence of rate values. Applies if the `rateValues` array is empty.
+  * 
+  * Default value: 1
   */
   get rateMin(): number;
   set rateMin(val: number);
   /*
-  * This property is used to generate rate values if rateValues array is empty. It is the last value in the rating. The default value is 5.
+  * Specifies the last rate value in the generated sequence of rate values. Applies if the `rateValues` array is empty.
+  * 
+  * Default value: 5
   */
   get rateMax(): number;
   set rateMax(val: number);
   /*
-  * This property is used to generate rate values if rateValues array is empty. It is the step value. The number of rate values are (rateMax - rateMin) / rateStep. The default value is 1.
+  * Specifies a step with which to generate rate values. Applies if the `rateValues` array is empty.
+  * 
+  * Default value: 1
   */
   get rateStep(): number;
   set rateStep(val: number);
@@ -8408,13 +8462,13 @@ export declare class QuestionRatingModel extends Question {
   supportComment(): boolean;
   supportOther(): boolean;
   /*
-  * The description of minimum (first) item.
+  * Specifies a description for the minimum (first) rate value.
   */
   get minRateDescription(): string;
   set minRateDescription(val: string);
   get locMinRateDescription(): LocalizableString;
   /*
-  * The description of maximum (last) item.
+  * Specifies a description for the maximum (last) rate value.
   */
   get maxRateDescription(): string;
   set maxRateDescription(val: string);
@@ -8424,8 +8478,13 @@ export declare class QuestionRatingModel extends Question {
   get hasMinLabel(): boolean;
   get hasMaxLabel(): boolean;
   /*
-  * Specifies whether a Rating question displays the [minRateDescription](https://surveyjs.io/Documentation/Library?id=questionratingmodel#minRateDescription) and [maxRateDescription](https://surveyjs.io/Documentation/Library?id=questionratingmodel#maxRateDescription) property texts as buttons that correspond to the extreme (first and last) rate items. If any of these properties is empty, the corresponding rate item's value/text is used for display.
-  * When the `displayRateDescriptionsAsExtremeItems` property is disabled, the texts defined through the [minRateDescription](https://surveyjs.io/Documentation/Library?id=questionratingmodel#minRateDescription) and [maxRateDescription](https://surveyjs.io/Documentation/Library?id=questionratingmodel#maxRateDescription) properties are displayed as plain non-clickable texts.
+  * Specifies whether to display `minRateDescription` and `maxRateDescription` values as captions for buttons that correspond to the extreme (first and last) rate values.
+  * 
+  * Default value: `false`
+  * 
+  * If this property is disabled, the `minRateDescription` and `maxRateDescription` values are displayed as plain non-clickable texts.
+  * 
+  * If any of the `minRateDescription` and `maxRateDescription` properties is empty, the corresponding rate value's `value` or `text` is displayed as a button caption.
   */
   displayRateDescriptionsAsExtremeItems: boolean;
   /*
@@ -8439,9 +8498,6 @@ export declare class QuestionRatingModel extends Question {
   */
   displayMode: "dropdown" | "auto" | "buttons";
   protected valueToData(val: any): any;
-  /*
-  * Click value again to clear.
-  */
   setValueFromClick(value: any): void;
   get ratingRootCss(): string;
   getItemClass(item: ItemValue): string;
@@ -8687,7 +8743,7 @@ export declare class QuestionSelectBase extends Question {
   protected canShowOptionItem(item: ItemValue, isAddAll: boolean, hasItem: boolean): boolean;
   isItemInList(item: ItemValue): boolean;
   protected get isAddDefaultItems(): boolean;
-  getPlainData(options?: any): any;
+  getPlainData(options?: any): IQuestionPlainData;
   protected getDisplayValueCore(keysAsText: boolean, value: any): any;
   protected getDisplayValueEmpty(): string;
   protected getChoicesDisplayValue(items: any, val: any): any;
@@ -8774,7 +8830,9 @@ export declare class QuestionSelectBase extends Question {
   set itemComponent(val: string);
 }
 /*
-* A Model for signature pad question.
+* A class that describes the Signature Page question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/signature-pad-widget-javascript/ (linkStyle))
 */
 export declare class QuestionSignaturePadModel extends Question {
   constructor(name: string);
@@ -8787,41 +8845,45 @@ export declare class QuestionSignaturePadModel extends Question {
   initSignaturePad(el: any): void;
   destroySignaturePad(el: any): void;
   /*
-  * Use it to set the specific dataFormat for the signature pad image data.
-  * formats: "" (default) - png, "image/jpeg" - jpeg, "image/svg+xml" - svg
+  * Specifies the format in which to store the signature image.
+  * 
+  * Possible values:
+  * 
+  * - `""` (default) - PNG
+  * - `"image/jpeg"` - JPEG
+  * - `"image/svg+xml"` - SVG
   */
   dataFormat: string;
   /*
-  * Use it to set the specific width for the signature pad.
+  * Specifies the width of the signature area. Accepts positive integer numbers.
   */
   get signatureWidth(): number;
   set signatureWidth(val: number);
   /*
-  * Use it to set the specific height for the signature pad.
+  * Specifies the height of the signature area. Accepts positive integer numbers.
   */
   get signatureHeight(): number;
   set signatureHeight(val: number);
   get height(): number;
   set height(val: number);
   /*
-  * Use it to clear content of the signature pad.
+  * Specifies whether to display a button that clears the signature area.
+  * 
+  * Default value: `true`
   */
   get allowClear(): boolean;
   set allowClear(val: boolean);
   get canShowClearButton(): boolean;
   /*
-  * Use it to set pen color for the signature pad.
+  * Specifies a color for the pen. Accepts hexadecimal colors (`"#FF0000"`), RGB colors (`"rgb(255,0,0)"`), or color names (`"red"`).
   */
   get penColor(): string;
   set penColor(val: string);
   /*
-  * Use it to set background color for the signature pad.
+  * Specifies a color for the signature area background.  Accepts hexadecimal colors (`"#FF0000"`), RGB colors (`"rgb(255,0,0)"`), or color names (`"red"`).
   */
   get backgroundColor(): string;
   set backgroundColor(val: string);
-  /*
-  * The clear signature button caption.
-  */
   get clearButtonCaption(): string;
   needShowPlaceholder(): boolean;
   get placeHolderText(): string;
@@ -9051,6 +9113,7 @@ export declare class QuestionCustomModel extends QuestionCustomModelBase {
 export declare class QuestionDropdownModel extends QuestionSelectBase {
   constructor(name: string);
   dropdownListModel: DropdownListModel;
+  lastSelectedItemValue: ItemValue;
   updateReadOnlyText(): void;
   locStrsChanged(): void;
   get showOptionsCaption(): boolean;
@@ -9106,11 +9169,8 @@ export declare class QuestionDropdownModel extends QuestionSelectBase {
   */
   get choicesStep(): number;
   set choicesStep(val: number);
-  /*
-  * An [autocomplete](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete) attribute value for the underlying `<input>` element.
-  */
-  get autoComplete(): string;
-  set autoComplete(val: string);
+  get autocomplete(): string;
+  set autocomplete(val: string);
   /*
   * Specifies whether to display a button that clears the selected value.
   */
@@ -9134,6 +9194,7 @@ export declare class QuestionDropdownModel extends QuestionSelectBase {
   protected onVisibleChoicesChanged(): void;
   protected getFirstInputElementId(): string;
   getInputId(): string;
+  clearValue(): void;
   onClick(e: any): void;
   onKeyUp(event: any): void;
 }
@@ -9439,7 +9500,7 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
   get optionsCaption(): string;
   set optionsCaption(val: string);
   /*
-  * An error message displayed when users enter a duplicate value into a column that accepts only unique values (`isUnique` is set to `true`).
+  * An error message displayed when users enter a duplicate value into a column that accepts only unique values (`isUnique` is set to `true` or `keyName` is specified).
   * 
   * 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).
   */
@@ -9468,7 +9529,7 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
   protected getRowValueCore(row: MatrixDropdownRowModelBase, questionValue: any, create?: boolean): any;
   protected getRowObj(row: MatrixDropdownRowModelBase): any;
   protected getRowDisplayValue(keysAsText: boolean, row: MatrixDropdownRowModelBase, rowValue: any): any;
-  getPlainData(options?: any): any;
+  getPlainData(options?: any): IQuestionPlainData;
   addConditionObjectsByContext(objects: any, context: any): void;
   protected getConditionObjectRowName(index: number): string;
   protected getConditionObjectRowText(index: number): string;
@@ -9526,7 +9587,9 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
   protected getIsTooltipErrorInsideSupported(): boolean;
 }
 /*
-* A Model for a simple matrix question.
+* A class that describes the Single-Choice Matrix question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/single-selection-matrix-table-question/ (linkStyle))
 */
 export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixRowModel, ItemValue> implements IMatrixData, IMatrixCellsOwner {
   constructor(name: string);
@@ -9535,21 +9598,23 @@ export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixR
   getType(): string;
   get hasSingleInput(): boolean;
   /*
-  * Set this property to true, if you want a user to answer all rows.
+  * Specifies whether each row requires an answer. If a respondent skips a row, the question displays a validation error.
   */
   get isAllRowRequired(): boolean;
   set isAllRowRequired(val: boolean);
-  /*
-  * Returns true, if there is at least one row.
-  */
   get hasRows(): boolean;
   /*
-  * Use this property to render items in a specific order: "random" or "initial". Default is "initial".
+  * Specifies a sort order for matrix rows.
+  * 
+  * Possible values:
+  * 
+  * - "initial" (default) - Preserves the original order of the `rows` array.
+  * - "random" - Arranges matrix rows in random order each time the question is displayed.
   */
   get rowsOrder(): string;
   set rowsOrder(val: string);
   /*
-  * Set this property to true to hide the question if there is no visible rows in the matrix.
+  * Specifies whether to hide the question when the matrix has no visible rows.
   */
   get hideIfRowsEmpty(): boolean;
   set hideIfRowsEmpty(val: boolean);
@@ -9564,9 +9629,6 @@ export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixR
   protected sortVisibleRows(array: any): Array<MatrixRowModel>;
   endLoadingFromJson(): void;
   protected processRowsOnSet(newRows: any): any;
-  /*
-  * Returns the list of visible rows as model objects.
-  */
   get visibleRows(): any;
   get cells(): MatrixCells;
   set cells(val: MatrixCells);
@@ -9585,7 +9647,7 @@ export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixR
   protected onMatrixRowCreated(row: MatrixRowModel): void;
   protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
   protected getDisplayValueCore(keysAsText: boolean, value: any): any;
-  getPlainData(options?: any): any;
+  getPlainData(options?: any): IQuestionPlainData;
   addConditionObjectsByContext(objects: any, context: any): void;
   getConditionJson(operator?: string, path?: string): any;
   protected clearValueIfInvisibleCore(): void;
@@ -9599,7 +9661,9 @@ export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixR
   getRowHeaderWrapperComponentData(cell: ItemValue): any;
 }
 /*
-* A Model for an input text question.
+* A class that describes the Text question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-text/ (linkStyle))
 */
 export declare class QuestionTextModel extends QuestionTextBase {
   constructor(name: string);
@@ -9610,7 +9674,7 @@ export declare class QuestionTextModel extends QuestionTextBase {
   getType(): string;
   onSurveyLoad(): void;
   /*
-  * Use this property to change the default input type.
+  * A value passed on to the [`type`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#input_types) attribute of the underlying `<input>` element.
   */
   get inputType(): string;
   set inputType(val: string);
@@ -9618,7 +9682,7 @@ export declare class QuestionTextModel extends QuestionTextBase {
   getValidators(): Array<SurveyValidator>;
   isLayoutTypeSupported(layoutType: string): boolean;
   /*
-  * The text input size
+  * A value passed on to the [`size`](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/size) attribute of the underlying `<input>` element.
   */
   get size(): number;
   set size(val: number);
@@ -9628,52 +9692,52 @@ export declare class QuestionTextModel extends QuestionTextBase {
   get inputWidth(): string;
   updateInputSize(): void;
   /*
-  * Text auto complete
+  * A value passed on to the [`autocomplete`](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete) attribute of the underlying `<input>` element.
   */
-  get autoComplete(): string;
-  set autoComplete(val: string);
+  get autocomplete(): string;
+  set autocomplete(val: string);
   /*
-  * The minimum value
+  * A value passed on to the [`min`](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/min) attribute of the underlying `<input>` element.
   */
   get min(): string;
   set min(val: string);
   /*
-  * The maximum value
+  * A value passed on to the [`max`](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/max) attribute of the underlying `<input>` element.
   */
   get max(): string;
   set max(val: string);
   /*
-  * The minimum value that you can setup as expression, for example today(-1) = yesterday;
+  * The minimum value specified as an expression. For example, `"minValueExpression": "today(-1)"` sets the minimum value to yesterday.
   */
   get minValueExpression(): string;
   set minValueExpression(val: string);
   /*
-  * The maximum value that you can setup as expression, for example today(1) = tomorrow;
+  * The maximum value specified as an expression. For example, `"maxValueExpression": "today(1)"` sets the maximum value to tomorrow.
   */
   get maxValueExpression(): string;
   set maxValueExpression(val: string);
   get renderedMin(): any;
   get renderedMax(): any;
   /*
-  * The text that shows when value is less than min property.
+  * An error message to display when the question value is less than the minimum accepted value.
   */
   get minErrorText(): string;
   set minErrorText(val: string);
   get locMinErrorText(): LocalizableString;
   /*
-  * The text that shows when value is greater than man property.
+  * An error message to display when the question value exceeds the maximum accepted value.
   */
   get maxErrorText(): string;
   set maxErrorText(val: string);
   get locMaxErrorText(): LocalizableString;
   /*
-  * Readonly property that returns true if the current inputType allows to set min and max properties
+  * Returns `true` if the specified `inputType` supports the `min` and `max` properties.
   */
   get isMinMaxType(): boolean;
   protected onCheckForErrors(errors: any, isOnValueChanged: boolean): void;
   protected canSetValueToSurvey(): boolean;
   /*
-  * The step value
+  * A value passed on to the [`step`](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step) attribute of the underlying `<input>` element.
   */
   get step(): string;
   set step(val: string);
@@ -9681,7 +9745,7 @@ export declare class QuestionTextModel extends QuestionTextBase {
   supportGoNextPageAutomatic(): boolean;
   supportGoNextPageError(): boolean;
   /*
-  * The list of recommended options available to choose.
+  * An array of predefined options from which users can select. This property configures an HTML [`<datalist>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/datalist) element and associates it with the underlying `input` element.
   */
   get dataList(): any;
   set dataList(val: any);
@@ -9902,26 +9966,28 @@ export declare class QuestionImagePickerModel extends QuestionCheckboxBase {
   afterRender(el: any): void;
 }
 /*
-* A Model for a matrix dropdown question. You may use a dropdown, checkbox, radiogroup, text and comment questions as a cell editors.
+* A class that describes the Multiple-Choice Matrix question type. Multiple-Choice Matrix allows you to use the [Dropdown](https://surveyjs.io/form-library/documentation/questiondropdownmodel), [Checkbox](https://surveyjs.io/form-library/documentation/questioncheckboxmodel), [Radiogroup](https://surveyjs.io/form-library/documentation/questionradiogroupmodel), [Text](https://surveyjs.io/form-library/documentation/questiontextmodel), and [Comment](https://surveyjs.io/form-library/documentation/questioncommentmodel) question types as cell editors.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-matrixdropdown/ (linkStyle))
 */
 export declare class QuestionMatrixDropdownModel extends QuestionMatrixDropdownModelBase implements IMatrixDropdownData {
   constructor(name: string);
   getType(): string;
   /*
-  * Set this property to show it on the first column for the total row.
+  * A title for the total row. Applies if at least one column displays total values.
   */
   get totalText(): string;
   set totalText(val: string);
   get locTotalText(): LocalizableString;
   getFooterText(): LocalizableString;
   /*
-  * The column width for the first column, row title column.
+  * A width for the column that displays row titles (first column). Accepts CSS values.
   */
   get rowTitleWidth(): string;
   set rowTitleWidth(val: string);
   getRowTitleWidth(): string;
   /*
-  * Set this property to true to hide the question if there is no visible rows in the matrix.
+  * Specifies whether to hide the question when the matrix has no visible rows.
   */
   get hideIfRowsEmpty(): boolean;
   set hideIfRowsEmpty(val: boolean);
@@ -9938,8 +10004,11 @@ export declare class QuestionMatrixDropdownModel extends QuestionMatrixDropdownM
   protected updateProgressInfoByValues(res: IProgressInfo): void;
 }
 /*
-* A Model for a matrix dymanic question. You may use a dropdown, checkbox, radiogroup, text and comment questions as a cell editors.
-* An end-user may dynamically add/remove rows, unlike in matrix dropdown question.
+* A class that describes the Dynamic Matrix question type.
+* 
+* Dynamic Matrix allows respondents to add and delete matrix rows. You can use the [Dropdown](https://surveyjs.io/form-library/documentation/questiondropdownmodel), [Checkbox](https://surveyjs.io/form-library/documentation/questioncheckboxmodel), [Radiogroup](https://surveyjs.io/form-library/documentation/questionradiogroupmodel), [Text](https://surveyjs.io/form-library/documentation/questiontextmodel), and [Comment](https://surveyjs.io/form-library/documentation/questioncommentmodel) question types as cell editors.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/ (linkStyle))
 */
 export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownModelBase implements IMatrixDropdownData {
   constructor(name: string);
@@ -9955,12 +10024,12 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
   getType(): string;
   get isRowsDynamic(): boolean;
   /*
-  * Set it to true, to show a confirmation dialog on removing a row
+  * Specifies whether to display a confirmation dialog when a respondent wants to delete a row.
   */
   get confirmDelete(): boolean;
   set confirmDelete(val: boolean);
   /*
-  * Set it to a column name and the library shows duplication error, if there are same values in different rows in the column.
+  * Specifies a key column. Set this property to a column name, and the question will display `keyDuplicationError` if a user tries to enter a duplicate value in this column.
   */
   get keyName(): string;
   set keyName(val: string);
@@ -9970,8 +10039,9 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
   get defaultRowValue(): any;
   set defaultRowValue(val: any);
   /*
-  * Set it to true to copy the value into new added row from the last row. If defaultRowValue is set and this property equals to true,
-  * then the value for new added row is merging.
+  * Specifies whether default values for a new row/column should be copied from the last row/column.
+  * 
+  * If you also specify `defaultValue`, it will be merged with the copied values.
   */
   get defaultValueFromLastRow(): boolean;
   set defaultValueFromLastRow(val: boolean);
@@ -9986,39 +10056,61 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
   set rowCount(val: number);
   protected updateProgressInfoByValues(res: IProgressInfo): void;
   /*
-  * Set this property to true, to allow rows drag and drop.
+  * Specifies whether users can drag and drop matrix rows to reorder them.
+  * 
+  * Default value: `false`
   */
   get allowRowsDragAndDrop(): boolean;
   set allowRowsDragAndDrop(val: boolean);
   get iconDragElement(): string;
   protected createRenderedTable(): QuestionMatrixDropdownRenderedTable;
   /*
-  * The minimum row count. A user could not delete a row if the rowCount equals to minRowCount
+  * A minimum number of rows in the matrix. Users cannot delete rows if `rowCount` equals `minRowCount`.
+  * 
+  * Default value: 0
   */
   get minRowCount(): number;
   set minRowCount(val: number);
   /*
-  * The maximum row count. A user could not add a row if the rowCount equals to maxRowCount
+  * A maximum number of rows in the matrix. Users cannot add new rows if `rowCount` equals `maxRowCount`.
+  * 
+  * Default value: 1000 (inherited from [`settings.matrixMaximumRowCount`](https://surveyjs.io/form-library/documentation/settings#matrixMaximumRowCount))
   */
   get maxRowCount(): number;
   set maxRowCount(val: number);
   /*
-  * Set this property to false to disable ability to add new rows. "Add new Row" button becomes invsible in UI
+  * Specifies whether users are allowed to add new rows.
+  * 
+  * Default value: `true`
   */
   get allowAddRows(): boolean;
   set allowAddRows(val: boolean);
   /*
-  * Set this property to false to disable ability to remove rows. "Remove" row buttons become invsible in UI
+  * Specifies whether users are allowed to delete rows.
+  * 
+  * Default value: `true`
   */
   get allowRemoveRows(): boolean;
   set allowRemoveRows(val: boolean);
   /*
-  * Returns true, if a new row can be added.
+  * Indicates whether it is possible to add a new row.
+  * 
+  * This property returns `true` when all of the following conditions apply:
+  * 
+  * - Users are allowed to add new rows (`allowAddRows` is `true`).
+  * - The question, panel, or survey is not in read-only state.
+  * - `rowCount` does not exceed `maxRowCount`
   */
   get canAddRow(): boolean;
   canRemoveRowsCallback: (allow: boolean) => boolean;
   /*
-  * Returns true, if row can be removed.
+  * Indicates whether it is possible to delete rows.
+  * 
+  * This property returns `true` when all of the following conditions apply:
+  * 
+  * - Users are allowed to delete rows (`allowRemoveRows` is `true`).
+  * - The question, panel, or survey is not in read-only state.
+  * - `rowCount` exceeds `minRowCount`
   */
   get canRemoveRows(): boolean;
   canRemoveRow(row: MatrixDropdownRowModelBase): boolean;
@@ -10031,7 +10123,7 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
   */
   addRow(): void;
   /*
-  * Set this property to true to show detail panel immediately on adding a new row.
+  * Specifies whether to expand the detail section immediately when a respondent adds a new row.
   */
   get detailPanelShowOnAdding(): boolean;
   set detailPanelShowOnAdding(val: boolean);
@@ -10048,26 +10140,35 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
   */
   removeRow(index: number): void;
   /*
-  * Use this property to change the default text showing in the confirmation delete dialog on removing a row.
+  * A message displayed in a confirmation dialog that appears when a respondent wants to delete a row.
   */
   get confirmDeleteText(): string;
   set confirmDeleteText(val: string);
   get locConfirmDeleteText(): LocalizableString;
   /*
-  * Use this property to change the default value of add row button text.
+  * A caption for the Add Row button.
   */
   get addRowText(): string;
   set addRowText(val: string);
   get locAddRowText(): LocalizableString;
   /*
-  * By default the 'Add Row' button is shown on bottom if columnLayout is horizontal and on top if columnLayout is vertical.
-  * You may set it to "top", "bottom" or "topBottom" (to show on top and bottom).
+  * Specifies the location of the Add Row button.
+  * 
+  * Possible values:
+  * 
+  * - `"top"` - Displays the Add Row button at the top of the matrix.
+  * - `"bottom"` - Displays the Add Row button at the bottom of the matrix.
+  * - `"topBottom"` - Displays the Add Row button at the top and bottom of the matrix.
+  * 
+  * Default value: `"top"` if `columnLayout` is `vertical`; `"bottom"` if `columnLayout` is `"horizontal"` or the matrix is in compact mode.
   */
   get addRowLocation(): string;
   set addRowLocation(val: string);
   getAddRowLocation(): string;
   /*
-  * Set this property to true to hide matrix columns when there is no any row.
+  * Specifies whether to hide columns when the matrix does not contain any rows. If you enable this property, the matrix displays the `emptyRowsText` message and the Add Row button.
+  * 
+  * Default value: `false`
   */
   get hideColumnsIfEmpty(): boolean;
   set hideColumnsIfEmpty(val: boolean);
@@ -10079,7 +10180,7 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
   set removeRowText(val: string);
   get locRemoveRowText(): LocalizableString;
   /*
-  * Use this property to change the default value of remove row button text.
+  * A message displayed when the matrix does not contain any rows. Applies only if `hideColumnsIfEmpty` is enabled.
   */
   get emptyRowsText(): string;
   set emptyRowsText(val: string);
@@ -10102,7 +10203,9 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
   getRootCss(): string;
 }
 /*
-* A Model for a radiogroup question.
+* A class that describes the Radiogroup question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-radiogroup/ (linkStyle))
 */
 export declare class QuestionRadiogroupModel extends QuestionCheckboxBase {
   constructor(name: string);
@@ -10112,11 +10215,13 @@ export declare class QuestionRadiogroupModel extends QuestionCheckboxBase {
   get titleAriaLabel(): string;
   protected getFirstInputElementId(): string;
   /*
-  * Return the selected item in the radio group. Returns null if the value is empty
+  * Returns the selected choice item. If no item is selected, returns `null`.
   */
   get selectedItem(): ItemValue;
   /*
-  * Show "clear button" flag.
+  * Specifies whether to display a button that clears the question value.
+  * 
+  * Default value: `false`
   */
   get showClearButton(): boolean;
   set showClearButton(val: boolean);
@@ -10127,7 +10232,9 @@ export declare class QuestionRadiogroupModel extends QuestionCheckboxBase {
   protected getDefaultTitleActions(): Array<Action>;
 }
 /*
-* A Model for a ranking question
+* A class that describes the Ranking question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-ranking/ (linkStyle))
 */
 export declare class QuestionRankingModel extends QuestionCheckboxModel {
   constructor(name: string);
@@ -10168,7 +10275,11 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
   getIconHoverCss(): string;
   getIconFocusCss(): string;
   /*
-  * For mobile devices. Set this property to false, to disable the "long tap" before drag start. Default is true.
+  * Specifies whether to use a long tap (press and hold) gesture to start dragging.
+  * 
+  * Default value: `true`
+  * 
+  * Disable this property if you want to start dragging when users perform a scroll gesture.
   */
   get longTap(): boolean;
   set longTap(val: boolean);
@@ -10482,6 +10593,7 @@ export declare var defaultActionBarCss: {
 export declare var defaultListCss: {
   root: string,
   item: string,
+  loadingIndicator: string,
   itemSelected: string,
   itemWithIcon: string,
   itemDisabled: string,
@@ -11051,6 +11163,7 @@ export declare var defaultBootstrapCss: {
     root: string,
     selectWrapper: string,
     control: string,
+    controlValue: string,
     other: string,
     cleanButton: string,
     cleanButtonSvg: string,
@@ -11389,6 +11502,7 @@ export declare var defaultBootstrapMaterialCss: {
     root: string,
     selectWrapper: string,
     control: string,
+    controlValue: string,
     other: string,
     cleanButton: string,
     cleanButtonSvg: string,