survey-react 1.9.52 → 1.9.53

package/survey.react.d.ts

@@ -1,5 +1,5 @@
 /*
-* Type definition for Survey JavaScript library for React v1.9.52
+* Type definition for Survey JavaScript library for React v1.9.53
 * Copyright (c) 2015-2022 Devsoft Baltic OÜ  - https://surveyjs.io/
 * License: MIT (http://www.opensource.org/licenses/mit-license.php)
 */
@@ -923,6 +923,7 @@ export declare class Base {
   protected setArray(name: string, src: any, dest: any, isItemValues: boolean, onPush: any): void;
   protected isTwoValueEquals(x: any, y: any, caseInSensitive?: boolean, trimString?: boolean): boolean;
   protected copyCssClasses(dest: any, source: any): void;
+  getElementsInDesign(includeHidden?: boolean): Array<IElement>;
 }
 export declare class Bindings {
   constructor(obj: Base);
@@ -2709,7 +2710,7 @@ export declare class Popup extends SurveyElementBase<IPopupProps, any> {
   popup: any;
   containerRef: any;
   get model(): any;
-  protected getStateElement(): any;
+  protected getStateElement(): Base;
   componentDidMount(): void;
   componentDidUpdate(prevProps: any, prevState: any): void;
   componentWillUnmount(): void;
@@ -2717,40 +2718,43 @@ export declare class Popup extends SurveyElementBase<IPopupProps, any> {
   render(): JSX.Element;
 }
 export declare class PopupBaseViewModel extends Base {
-  constructor(model: any, targetElement?: any);
-  targetElement: any;
-  isAutoScroll: boolean;
-  prevActiveElement: any;
-  scrollEventCallBack: any;
+  constructor(model: any);
+  protected prevActiveElement: any;
+  protected footerToolbarValue: any;
   top: string;
   left: string;
   height: string;
   width: string;
   minWidth: string;
   isVisible: boolean;
-  popupDirection: string;
-  pointerTarget: IPosition;
   container: any;
+  protected hidePopup(): void;
+  protected getStyleClass(): CssClassBuilder;
+  protected getShowFooter(): boolean;
+  protected getShowHeader(): boolean;
+  protected getPopupHeaderTemplate(): string;
+  protected createFooterActionBar(): void;
   _model: any;
   get model(): any;
   set model(val: any);
   get title(): string;
   get contentComponentName(): string;
   get contentComponentData(): any;
-  get showPointer(): boolean;
   get isModal(): boolean;
   get isFocusedContent(): boolean;
   get showFooter(): boolean;
+  get showHeader(): boolean;
+  get popupHeaderTemplate(): string;
   get isOverlay(): boolean;
   get styleClass(): string;
+  get cancelButtonText(): string;
+  get footerToolbar(): any;
   onKeyDown(event: any): void;
+  switchFocus(): void;
   updateOnShowing(): void;
   updateOnHiding(): void;
   clickOutside(): void;
   cancel(): void;
-  apply(): void;
-  get cancelButtonText(): string;
-  get applyButtonText(): string;
   dispose(): void;
   initializePopupContainer(): void;
   unmountPopupContainer(): void;
@@ -2760,16 +2764,14 @@ export declare class PopupContainer extends SurveyElementBase<any, any> {
   prevIsVisible: boolean;
   handleKeydown: (event: any) => void;
   get model(): any;
-  protected getStateElement(): any;
+  protected getStateElement(): Base;
   clickInside: (ev: any) => void;
   componentDidUpdate(prevProps: any, prevState: any): void;
-  renderContainer(): JSX.Element;
-  renderPointer(): JSX.Element;
-  renderHeader(): JSX.Element;
+  renderContainer(PopupBaseViewModel: any): JSX.Element;
+  renderHeaderContent(): JSX.Element;
   renderContent(): JSX.Element;
-  renderCancelButton(): JSX.Element;
-  renderApplyButton(): JSX.Element;
-  renderFooter(): JSX.Element;
+  protected renderHeaderPopup(popupModel: any): JSX.Element;
+  protected renderFooter(popuModel: any): JSX.Element;
   render(): JSX.Element;
 }
 export declare class PopupModel<T = any> extends Base {
@@ -3633,6 +3635,34 @@ export declare class NumericValidator extends SurveyValidator {
   get maxValue(): number;
   set maxValue(val: number);
 }
+export declare class PopupDropdownContainer extends PopupContainer {
+  constructor(props: any);
+  protected renderHeaderPopup(popupModel: any): JSX.Element;
+}
+export declare class PopupDropdownViewModel extends PopupBaseViewModel {
+  constructor(model: any, targetElement?: any);
+  targetElement: any;
+  isAutoScroll: boolean;
+  scrollEventCallBack: any;
+  protected hidePopup(): void;
+  protected getStyleClass(): CssClassBuilder;
+  protected getShowHeader(): boolean;
+  protected getPopupHeaderTemplate(): string;
+  popupDirection: string;
+  pointerTarget: IPosition;
+  updateOnShowing(): void;
+  updateOnHiding(): void;
+}
+export declare class PopupModalViewModel extends PopupBaseViewModel {
+  constructor(model: any);
+  protected getStyleClass(): CssClassBuilder;
+  protected getShowFooter(): boolean;
+  protected createFooterActionBar(): void;
+  get applyButtonText(): string;
+  apply(): void;
+  clickOutside(): void;
+  onKeyDown(event: any): void;
+}
 export declare class PopupSurvey extends Survey {
   constructor(props: any);
   protected popup: any;
@@ -3833,7 +3863,6 @@ export declare class SurveyElement extends SurveyElementCore implements ISurveyE
   get containsErrors(): boolean;
   updateContainsErrors(): void;
   protected getContainsErrors(): boolean;
-  getElementsInDesign(includeHidden?: boolean): Array<IElement>;
   get selectedElementInDesign(): SurveyElement;
   set selectedElementInDesign(val: SurveyElement);
   updateCustomWidgets(): void;
@@ -6119,6 +6148,7 @@ export declare class SurveyQuestionRankingItem extends ReactSurveyElement {
   protected get handlePointerDown(): (event: any) => void;
   protected get cssClasses(): any;
   protected get itemClass(): string;
+  protected get itemTabIndex(): number;
   protected get question(): any;
   protected renderElement(): JSX.Element;
 }
@@ -6839,8 +6869,10 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   get requiredIf(): string;
   set requiredIf(val: string);
   /*
-  * Specifies whether to display a comment area. Incompatible with the `hasOther` property.
+  * Specifies whether to display a comment area. Incompatible with the `showOtherItem` property.
   */
+  get showCommentArea(): boolean;
+  set showCommentArea(val: boolean);
   get hasComment(): boolean;
   set hasComment(val: boolean);
   /*
@@ -6853,6 +6885,8 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   /*
   * Specifies whether to display the "Other" choice item. Incompatible with the `hasComment` property.
   */
+  get showOtherItem(): boolean;
+  set showOtherItem(val: boolean);
   get hasOther(): boolean;
   set hasOther(val: boolean);
   protected hasOtherChanged(): void;
@@ -7459,60 +7493,65 @@ export declare class PanelModel extends PanelModelBase implements IElement {
   getContainerCss(): string;
 }
 /*
-* A Model for a boolean question.
+* A class that describes the Boolean question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-boolean/ (linkStyle))
 */
 export declare class QuestionBooleanModel extends Question {
   constructor(name: string);
   getType(): string;
   isLayoutTypeSupported(layoutType: string): boolean;
   supportGoNextPageAutomatic(): boolean;
-  /*
-  * Returns true if the question check will be rendered in indeterminate mode. value is empty.
-  */
   get isIndeterminate(): boolean;
   get hasTitle(): boolean;
   /*
-  * Get/set question value in 3 modes: indeterminate (value is empty), true (check is set) and false (check is unset).
+  * Gets or sets the question value as a Boolean value.
+  * 
+  * If you set the `valueTrue` and `valueFalse` properties, the `value` property contains their values instead of Boolean values. This may be inconvenient when you operate the question value in code. To access the standard Boolean values, use the `booleanValue` property.
+  */
+  get booleanValue(): any;
+  set booleanValue(val: any);
+  /*
+  * Obsolete, please use booleanValue property
   */
   get checkedValue(): any;
   set checkedValue(val: any);
-  /*
-  * Set the default state of the check: "indeterminate" - default (value is empty/null), "true" - value equals valueTrue or true, "false" - value equals valueFalse or false.
-  */
   get defaultValue(): any;
   set defaultValue(val: any);
   getDefaultValue(): any;
   get locTitle(): LocalizableString;
-  /*
-  * The checkbox label. If it is empty and showTitle is false then title is rendered
-  */
   get label(): string;
   set label(val: string);
   get locLabel(): LocalizableString;
   get locDisplayLabel(): LocalizableString;
   /*
-  * Set this property, if you want to have a different label for state when check is set.
+  * Gets or sets a text label that corresponds to a positive answer.
+  * 
+  * Default value: "Yes"
   */
   get labelTrue(): any;
   set labelTrue(val: any);
   get locLabelTrue(): LocalizableString;
   get isDeterminated(): boolean;
   /*
-  * Set this property, if you want to have a different label for state when check is unset.
+  * Gets or sets a text label that corresponds to a negative answer.
+  * 
+  * Default value: "No"
   */
   get labelFalse(): any;
   set labelFalse(val: any);
   get locLabelFalse(): LocalizableString;
-  /*
-  * Set this property to true to show the question title. It is hidden by default.
-  */
   showTitle: boolean;
   /*
-  * Set this property, if you want to have a different value from true when check is set.
+  * A value to save in survey results when respondents give a positive answer.
+  * 
+  * Default value: `true`
   */
   valueTrue: any;
   /*
-  * Set this property, if you want to have a different value from false when check is unset.
+  * A value to save in survey results when respondents give a negative answer.
+  * 
+  * Default value: `false`
   */
   valueFalse: any;
   protected setDefaultValue(): void;
@@ -7580,7 +7619,9 @@ export declare class QuestionEmptyModel extends Question {
   getType(): string;
 }
 /*
-* A Model for expression question. It is a read-only question. It calculates value based on epxression property.
+* A class that describes the Expression question type. It is a read-only question type that calculates a value based on a specified expression.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-expression/ (linkStyle))
 */
 export declare class QuestionExpressionModel extends Question {
   constructor(name: string);
@@ -7589,14 +7630,15 @@ export declare class QuestionExpressionModel extends Question {
   getType(): string;
   get hasInput(): boolean;
   /*
-  * Use this property to display the value in your own format. Make sure you have "{0}" substring in your string, to display the actual value.
+  * A string that formats a question value. Use `{0}` to reference the question value in the format string.
   */
   get format(): string;
   set format(val: string);
   get locFormat(): LocalizableString;
   /*
-  * The Expression that used to calculate the question value. You may use standard operators like +, -, * and /, squares (). Here is the example of accessing the question value {questionname}.
-  * Example: "({quantity} * {price}) * (100 - {discount}) / 100"
+  * An expression used to calculate the question value.
+  * 
+  * Refer to the following help topic for more information: [Expressions](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#expressions).
   */
   get expression(): string;
   set expression(val: string);
@@ -7606,12 +7648,16 @@ export declare class QuestionExpressionModel extends Question {
   protected canCollectErrors(): boolean;
   protected hasRequiredError(): boolean;
   /*
-  * The maximum number of fraction digits to use if displayStyle is not "none". Possible values are from 0 to 20. The default value is -1 and it means that this property is not used.
+  * The maximum number of fraction digits. Applies only if the `displayStyle` property is not `"none"`. Accepts values in the range from -1 to 20, where -1 disables the property.
+  * 
+  * Default value: -1
   */
   get maximumFractionDigits(): number;
   set maximumFractionDigits(val: number);
   /*
-  * The minimum number of fraction digits to use if displayStyle is not "none". Possible values are from 0 to 20. The default value is -1 and it means that this property is not used.
+  * The minimum number of fraction digits. Applies only if the `displayStyle` property is not `"none"`. Accepts values in the range from -1 to 20, where -1 disables the property.
+  * 
+  * Default value: -1
   */
   get minimumFractionDigits(): number;
   set minimumFractionDigits(val: number);
@@ -7624,17 +7670,31 @@ export declare class QuestionExpressionModel extends Question {
   updateValueFromSurvey(newValue: any): void;
   protected getDisplayValueCore(keysAsText: boolean, value: any): any;
   /*
-  * You may set this property to "decimal", "currency", "percent" or "date". If you set it to "currency", you may use the currency property to display the value in currency different from USD.
+  * Specifies a display style for the question value.
+  * 
+  * Possible values:
+  * 
+  * - `"decimal"`
+  * - `"currency"`
+  * - `"percent"`
+  * - `"date"`
+  * - `"none"` (default)
+  * 
+  * If you use the `"currency"` display style, you can also set the `currency` property to specify a currency other than USD.
   */
   get displayStyle(): string;
   set displayStyle(val: string);
   /*
-  * Use it to display the value in the currency differen from USD. The displayStype should be set to "currency".
+  * A three-letter currency code. Applies only if the `displayStyle` property is set to `"currency"`.
+  * 
+  * Default value: "USD".
   */
   get currency(): string;
   set currency(val: string);
   /*
-  * Determines whether to display grouping separators. The default value is true.
+  * Specifies whether to use grouping separators in number representation. Separators depend on the selected [locale](https://surveyjs.io/form-library/documentation/surveymodel#locale).
+  * 
+  * Default value: `true`
   */
   get useGrouping(): boolean;
   set useGrouping(val: boolean);
@@ -7788,7 +7848,8 @@ export declare class QuestionFileModel extends Question {
   /*
   * Remove file item programmatically.
   */
-  removeFile(content: any): void;
+  removeFile(name: string): void;
+  protected removeFileByContent(content: any): void;
   /*
   * Load multiple files programmatically.
   */
@@ -8275,9 +8336,7 @@ export declare class QuestionPanelDynamicModel extends Question implements IQues
 */
 export declare class QuestionRatingModel extends Question {
   constructor(name: string);
-  rateValuesChangedCallback: any;
   endLoadingFromJson(): void;
-  onSurveyLoad(): 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.
   */
@@ -8300,7 +8359,8 @@ export declare class QuestionRatingModel extends Question {
   set rateStep(val: number);
   protected getDisplayValueCore(keysAsText: boolean, value: any): any;
   get visibleRateValues(): any;
-  get renderedRateItems(): any;
+  itemValuePropertyChanged(item: ItemValue, name: string, oldValue: any, newValue: any): void;
+  renderedRateItems: any;
   getType(): string;
   protected getFirstInputElementId(): string;
   getInputId(index: number): string;
@@ -8360,7 +8420,7 @@ export declare class QuestionRatingModel extends Question {
   protected getDesktopRenderAs(): string;
 }
 /*
-* It is a base class for checkbox, dropdown and radiogroup questions.
+* A base class for multiple-choice question types ([Checkbox](https://surveyjs.io/form-library/documentation/questioncheckboxmodel), [Dropdown](https://surveyjs.io/form-library/documentation/questiondropdownmodel), [Radiogroup](https://surveyjs.io/form-library/documentation/questionradiogroupmodel), etc.).
 */
 export declare class QuestionSelectBase extends Question {
   constructor(name: string);
@@ -8389,35 +8449,51 @@ export declare class QuestionSelectBase extends Question {
   localeChanged(): void;
   locStrsChanged(): void;
   /*
-  * Returns the other item. By using this property, you may change programmatically it's value and text.
+  * Returns the "Other" choice item. Use this property to change the item's `value` or `text`.
   */
   get otherItem(): ItemValue;
   /*
-  * Returns true if a user select the 'other' item.
+  * Returns `true` if the "Other" choice item is selected.
   */
   get isOtherSelected(): boolean;
   /*
-  * Set this property to true, to show the "None" item on the bottom. If end-user checks this item, all other items would be unchecked.
+  * Specifies whether to display the "None" choice item.
+  * 
+  * When users select the "None" item in multi-select questions, all other items become unselected.
   */
+  get showNoneItem(): boolean;
+  set showNoneItem(val: boolean);
   get hasNone(): boolean;
   set hasNone(val: boolean);
   /*
-  * Returns the none item. By using this property, you may change programmatically it's value and text.
+  * Returns the "None" choice item. Use this property to change the item's `value` or `text`.
   */
   get noneItem(): ItemValue;
   /*
-  * Use this property to set the different text for none item.
+  * Gets or sets a caption for the "None" choice item.
   */
   get noneText(): string;
   set noneText(val: string);
   get locNoneText(): LocalizableString;
   /*
-  * An expression that returns true or false. It runs against each choices 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 choice item. If the expression evaluates to `false`, the choice item 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 choice item 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 choicesVisibleIf(): string;
   set choicesVisibleIf(val: string);
   /*
-  * An expression that returns true or false. It runs against each choices item and if for this item it returns true, then the item is enabled otherwise the item becomes disabled. Please use {item} to get the current item value in the expression.
+  * A Boolean expression that is evaluated against each choice item. If the expression evaluates to `false`, the choice item becomes read-only.
+  * 
+  * 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 choice item 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 choicesEnableIf(): string;
   set choicesEnableIf(val: string);
@@ -8461,50 +8537,78 @@ export declare class QuestionSelectBase extends Question {
   */
   clearIncorrectValuesCallback: any;
   /*
-  * Use this property to fill the choices from a RESTful service.
+  * Configures access to a RESTful service that returns choice items. Refer to the [ChoicesRestful](https://surveyjs.io/form-library/documentation/choicesrestful) class description for more information.
+  * 
+  * [View "Dropdown + RESTful" demo](https://surveyjs.io/form-library/examples/questiontype-dropdownrestfull/ (linkStyle))
   */
   get choicesByUrl(): ChoicesRestful;
   set choicesByUrl(val: ChoicesRestful);
   /*
-  * The list of items. Every item has value and text. If text is empty, the value is rendered. The item text supports markdown.
+  * Gets or sets choice items. This property accepts an array of objects with the following structure:
+  * 
+  * ```js
+  * {
+  *   "value": any, // A value to be saved in the survey results
+  *   "text": String, // A display text. This property supports Markdown. When `text` is undefined, `value` is used.
+  *   "imageLink": String // A link to the image or video that represents this choice value. Applies only to Image Picker questions.
+  *   "customProperty": any // Any property that you find useful
+  * }
+  * ```
+  * 
+  * Refer to the following help topic for information on how to add custom properties so that they are serialized into JSON: [Add Custom Properties to Property Grid](https://surveyjs.io/survey-creator/documentation/property-grid#add-custom-properties-to-the-property-grid).
+  * 
+  * 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);
   /*
-  * Set this property to get choices from the specified question instead of defining them in the current question. This avoids duplication of choices declaration in your survey definition.
-  * By setting this property, the "choices", "choicesVisibleIf", "choicesEnableIf" and "choicesOrder" properties become invisible, because these question characteristics depend on actions in another (specified) question.
-  * Use the `choicesFromQuestionMode` property to filter choices obtained from the specified question.
+  * Inherits choice items from a specified question. Accepts a question name.
+  * 
+  * If you specify this property, the `choices`, `choicesVisibleIf`, `choicesEnableIf`, and `choicesOrder` properties do not apply because their values are inherited.
+  * 
+  * In addition, you can specify the `choicesFromQuestionMode` property if you do not want to inherit all choice items.
   */
   get choicesFromQuestion(): string;
   set choicesFromQuestion(val: string);
   /*
-  * This property becomes visible when the `choicesFromQuestion` property is selected. The default value is "all" (all visible choices from another question are displayed as they are).
-  * You can set this property to "selected" or "unselected" to display only selected or unselected choices from the specified question.
+  * Specifies which choice items to inherit from another question. Applies only when the `choicesFromQuestion` property is specified.
+  * 
+  * Possible values:
+  * 
+  * - `"all"` (default) - Inherits all choice items.
+  * - `"selected"` - Inherits only selected choice items.
+  * - `"unselected"` - Inherits only unselected choice items.
+  * 
+  * Use the `visibleChoices` property to access inherited choice items.
   */
   get choicesFromQuestionMode(): string;
   set choicesFromQuestionMode(val: string);
   /*
-  * Set this property to true to hide the question if there is no visible choices.
+  * Specifies whether to hide the question if no choice items are visible.
+  * 
+  * This property is useful if you show or hide choice items at runtime based on a [condition](https://surveyjs.io/form-library/documentation/questionselectbase#choicesVisibleIf).
   */
   get hideIfChoicesEmpty(): boolean;
   set hideIfChoicesEmpty(val: boolean);
   get keepIncorrectValues(): boolean;
   set keepIncorrectValues(val: boolean);
-  /*
-  * Please use survey.storeOthersAsComment to change the behavior on the survey level. This property is depricated and invisible in Survey Creator.
-  * By default the entered text in the others input in the checkbox/radiogroup/dropdown are stored as "question name " + "-Comment". The value itself is "question name": "others". Set this property to false, to store the entered text directly in the "question name" key.
-  * Possible values are: "default", true, false
-  */
   get storeOthersAsComment(): any;
   set storeOthersAsComment(val: any);
   protected hasOtherChanged(): void;
   /*
-  * Use this property to render items in a specific order: "asc", "desc", "random". Default value is "none".
+  * Specifies the sort order of choice items.
+  * 
+  * Possible values:
+  * 
+  * - `"none"` (default) - Preserves the original order of choice items.
+  * - `"asc"`- Sorts choice items in ascending order.
+  * - `"desc"`- Sorts choice items in ascending order.
+  * - `"random"` - Displays choice items in random order.
   */
   get choicesOrder(): string;
   set choicesOrder(val: string);
   /*
-  * Use this property to set the different text for other item.
+  * Gets or sets a caption for the "Other" choice item.
   */
   get otherText(): string;
   set otherText(val: string);
@@ -8514,7 +8618,7 @@ export declare class QuestionSelectBase extends Question {
   */
   separateSpecialChoices: boolean;
   /*
-  * Use this property to set the place holder text for other or comment field  .
+  * A placeholder for the comment area. Applies when the `hasOther` or `hasComment` property is `true`.
   */
   get otherPlaceholder(): string;
   set otherPlaceholder(val: string);
@@ -8522,17 +8626,17 @@ export declare class QuestionSelectBase extends Question {
   get otherPlaceHolder(): string;
   set otherPlaceHolder(val: string);
   /*
-  * The text that shows when the other item is choosed by the other input is empty.
+  * Get or sets an error message displayed when users select the "Other" choice item but leave the comment area empty.
   */
   get otherErrorText(): string;
   set otherErrorText(val: string);
   get locOtherErrorText(): LocalizableString;
   /*
-  * The list of items as they will be rendered. If needed items are sorted and the other item is added.
+  * An array of visible choice items. Includes the "Select All", "Other", and "None" choice items if they are visible. Items are sorted according to the `choicesOrder` value.
   */
   get visibleChoices(): any;
   /*
-  * The list of enabled items as they will be rendered. The disabled items are not included
+  * An array of choice items with which users can interact. Includes the "Select All", "Other", and "None" choice items if they are not disabled. Items are sorted according to the `choicesOrder` value.
   */
   get enabledChoices(): any;
   protected updateVisibleChoices(): void;
@@ -8541,15 +8645,9 @@ export declare class QuestionSelectBase extends Question {
   get newItem(): ItemValue;
   protected addToVisibleChoices(items: any, isAddAll: boolean): void;
   protected canShowOptionItem(item: ItemValue, isAddAll: boolean, hasItem: boolean): boolean;
-  /*
-  * For internal use in SurveyJS Creator V2.
-  */
   isItemInList(item: ItemValue): boolean;
   protected get isAddDefaultItems(): boolean;
   getPlainData(options?: any): any;
-  /*
-  * Returns the text for the current value. If the value is null then returns empty string. If 'other' is selected then returns the text for other value.
-  */
   protected getDisplayValueCore(keysAsText: boolean, value: any): any;
   protected getDisplayValueEmpty(): string;
   protected getChoicesDisplayValue(items: any, val: any): any;
@@ -8586,7 +8684,9 @@ export declare class QuestionSelectBase extends Question {
   protected hasValueToClearIncorrectValues(): boolean;
   protected clearValueIfInvisibleCore(): void;
   /*
-  * Returns true if item is selected
+  * Returns `true` if a passed choice item is selected.
+  * 
+  * To obtain a choice item to check, use the `noneItem` or `otherItem` property or the `choices` array.
   */
   isItemSelected(item: ItemValue): boolean;
   protected isItemSelectedCore(item: ItemValue): boolean;
@@ -8688,20 +8788,21 @@ export declare class QuestionSignaturePadModel extends Question {
   endLoadingFromJson(): void;
 }
 /*
-* A Base Model for a comment and text questions
+* A base class for the [Text](https://surveyjs.io/form-library/documentation/questiontextmodel) and [Comment](https://surveyjs.io/form-library/documentation/questioncommentmodel) question types.
 */
 export declare class QuestionTextBase extends Question {
   constructor(name: string);
   protected isTextValue(): boolean;
   /*
-  * The maximum text length. If it is -1, defaul value, then the survey maxTextLength property will be used.
-  * If it is 0, then the value is unlimited
+  * The maximum text length measured in characters. Assign 0 if the length should be unlimited.
+  * 
+  * Default value: -1 (inherits the actual value from the `SurveyModel`'s [`maxTextLength`](https://surveyjs.io/form-library/documentation/surveymodel#maxTextLength) property).
   */
   get maxLength(): number;
   set maxLength(val: number);
   getMaxLength(): any;
   /*
-  * Use this property to set the input place holder.
+  * A placeholder for the input field.
   */
   get placeholder(): string;
   set placeholder(val: string);
@@ -8712,14 +8813,15 @@ export declare class QuestionTextBase extends Question {
   getType(): string;
   isEmpty(): boolean;
   /*
-  * Gets or sets a value that specifies how the question updates it's value.
+  * Gets or sets a value that specifies when to update the question value.
   * 
-  * The following options are available:
-  * - `default` - get the value from survey.textUpdateMode
-  * - `onBlur` - the value is updated after an input loses the focus.
-  * - `onTyping` - update the value of text questions, "text" and "comment", on every key press.
+  * Possible values:
   * 
-  * Note, that setting to "onTyping" may lead to a performance degradation, in case you have many expressions in the survey.
+  * - `"onBlur"` - Updates the value after the input field loses focus.
+  * - `"onTyping"` - Updates the value on every key press.
+  * - `"default"` (default) - Inherits the value from the `SurveyModel`'s [`textUpdateMode`](https://surveyjs.io/form-library/documentation/surveymodel#textUpdateMode) property.
+  * 
+  * > NOTE: Do not use the `"onTyping"` mode if your survey contains many expressions. Expressions are reevaluated each time a question value is changed. In `"onTyping"` mode, the question value changes frequently. This may cause performance degradation.
   */
   get textUpdateMode(): string;
   set textUpdateMode(val: string);
@@ -8786,13 +8888,15 @@ export declare class FlowPanelModel extends PanelModel {
   getElementContentText(element: IElement): string;
 }
 /*
-* A base class for checkbox and radiogroup questions. It introduced a colCount property.
+* A base class for multiple-selection question types that can display choice items in multiple columns ([Checkbox](https://surveyjs.io/form-library/documentation/questioncheckboxmodel), [Radiogroup](https://surveyjs.io/form-library/documentation/questionradiogroupmodel), [Image Picker](https://surveyjs.io/form-library/documentation/questionimagepickermodel)).
 */
 export declare class QuestionCheckboxBase extends QuestionSelectBase {
   constructor(name: string);
   colCountChangedCallback: any;
   /*
-  * The number of columns for radiogroup and checkbox questions. Items are rendred in one line if the value is 0.
+  * Get or sets the number of columns used to arrange choice items.
+  * 
+  * Set this property to 0 if you want to display all items in one line. The default value depends on the available width.
   */
   get colCount(): number;
   set colCount(val: number);
@@ -8801,29 +8905,38 @@ export declare class QuestionCheckboxBase extends QuestionSelectBase {
   protected getSearchableItemValueKeys(keys: any): void;
 }
 /*
-* A Model for a comment question
+* A class that describes the Comment question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-comment/ (linkStyle))
 */
 export declare class QuestionCommentModel extends QuestionTextBase {
   constructor(name: string);
   element: any;
   /*
-  * The html rows attribute.
+  * Specifies the visible height of the comment area, measured in lines.
+  * 
+  * The value of this property is passed on to the `rows` attribute of the underlying `<textarea>` element.
   */
   get rows(): number;
   set rows(val: number);
   /*
-  * The html cols attribute.
+  * Specifies the visible width of the comment area, measured in average character width.
+  * 
+  * The value of this property is passed on to the `cols` attribute of the underlying `<textarea>` element.
   */
   get cols(): number;
   set cols(val: number);
   /*
-  * Accepts pressing the Enter key by end-users and accepts carriage return symbols - \n - in the question value assigned.
+  * Specifies whether the question allows line breaks.
+  * 
+  * When this property is enabled, a user can press Enter to insert line breaks. They are saved as `\n` in survey results. The Comment question also recognizes and interprets the `\n` sequence as a line break when you set the question `value` in code.
   */
   get acceptCarriageReturn(): boolean;
   set acceptCarriageReturn(val: boolean);
   /*
-  * Specifies whether the question's text area automatically expands its height to avoid the vertical scrollbar and to display the entire multi-line contents entered by respondents.
-  * Default value is false.
+  * Specifies whether the comment area automatically increases its height to accomodate multi-line content.
+  * 
+  * Default value: `false` (inherited from `SurveyModel`'s [`autoGrowComment`](https://surveyjs.io/form-library/documentation/surveymodel#autoGrowComment) property)
   */
   get autoGrow(): boolean;
   set autoGrow(val: boolean);
@@ -8891,7 +9004,9 @@ export declare class QuestionCustomModel extends QuestionCustomModelBase {
   protected getDisplayValueCore(keyAsText: boolean, value: any): any;
 }
 /*
-* A Model for a dropdown question
+* A class that describes the Dropdown question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-dropdown/ (linkStyle))
 */
 export declare class QuestionDropdownModel extends QuestionSelectBase {
   constructor(name: string);
@@ -8903,34 +9018,56 @@ export declare class QuestionDropdownModel extends QuestionSelectBase {
   get optionsCaption(): string;
   set optionsCaption(val: string);
   /*
-  * A text displayed in the input field when it doesn't have a value.
+  * A placeholder for the input field.
   */
   get placeholder(): string;
   set placeholder(val: string);
   get locPlaceholder(): LocalizableString;
+  get cleanCaption(): string;
+  set cleanCaption(val: string);
+  get locCleanCaption(): LocalizableString;
   getType(): string;
   get selectedItem(): ItemValue;
   supportGoNextPageAutomatic(): boolean;
   minMaxChoices: any;
   protected getChoices(): Array<ItemValue>;
   /*
-  * Use this and choicesMax property to automatically add choices. For example choicesMin = 1 and choicesMax = 10 will generate ten additional choices from 1 to 10.
+  * Use the `choicesMin`, `choicesMax`, and `choicesStep` properties to generate choice items automatically. For example, the configuration below generates three choice items: [10, 20, 30].
+  * 
+  * ```js
+  * "choicesMin": 10,
+  * "choicesMax": 30
+  * "choicesStep": 10
+  * ```
   */
   get choicesMin(): number;
   set choicesMin(val: number);
   /*
-  * Use this and choicesMax property to automatically add choices. For example choicesMin = 1 and choicesMax = 10 will generate ten additional choices from 1 to 10.
+  * Use the `choicesMin`, `choicesMax`, and `choicesStep` properties to generate choice items automatically. For example, the configuration below generates three choice items: [10, 20, 30].
+  * 
+  * ```js
+  * "choicesMin": 10,
+  * "choicesMax": 30
+  * "choicesStep": 10
+  * ```
   */
   get choicesMax(): number;
   set choicesMax(val: number);
   /*
-  * The default value is 1. It tells the value of the iterator between choicesMin and choicesMax properties.
-  * If choicesMin = 10, choicesMax = 30 and choicesStep = 10 then you will have only three additional choices: [10, 20, 30].
+  * Use the `choicesMin`, `choicesMax`, and `choicesStep` properties to generate choice items automatically. For example, the configuration below generates three choice items: [10, 20, 30].
+  * 
+  * ```js
+  * "choicesMin": 10,
+  * "choicesMax": 30
+  * "choicesStep": 10
+  * ```
+  * 
+  * The default value of the `choicesStep` property is 1.
   */
   get choicesStep(): number;
   set choicesStep(val: number);
   /*
-  * Dropdown auto complete
+  * 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);
@@ -8942,12 +9079,6 @@ export declare class QuestionDropdownModel extends QuestionSelectBase {
   * Specifies whether users can enter a value into the input field to filter the drop-down list.
   */
   searchEnabled: boolean;
-  /*
-  * The clean files button caption.
-  */
-  get cleanButtonCaption(): string;
-  set cleanButtonCaption(val: string);
-  get locCleanButtonCaption(): LocalizableString;
   inputHasValue: boolean;
   readOnlyText: string;
   getControlClass(): string;
@@ -9473,7 +9604,9 @@ export declare class QuestionButtonGroupModel extends QuestionCheckboxBase {
   supportOther(): boolean;
 }
 /*
-* A Model for a checkbox question
+* A class that describes the Checkbox question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-checkbox/ (linkStyle))
 */
 export declare class QuestionCheckboxModel extends QuestionCheckboxBase {
   constructor(name: string);
@@ -9485,52 +9618,56 @@ export declare class QuestionCheckboxModel extends QuestionCheckboxBase {
   protected onCreating(): void;
   protected getFirstInputElementId(): string;
   /*
-  * Set this property if you want to store the checkbox value as array of objects instead of array of values
-  * For example: if "valuePropertyName" equals car, then instead of having ["Ford", "Tesla"], you will have [{car: "Ford"}, {car: "Tesla"}]
+  * Specifies a property name used to store selected values.
+  * 
+  * Set this property if you want to store selected values in an array of objects instead of an array of primitive values. For example, if you set `valuePropertyName` to `"car"`, the `value` property will contain an array of objects `[{ car: "Ford" }, { car: "Tesla" }]`, not an array of string values `[ "Ford", "Tesla" ]`.
   */
   get valuePropertyName(): string;
   set valuePropertyName(val: string);
   getQuestionFromArray(name: string, index: number): IQuestion;
   /*
-  * Returns the select all item. By using this property, you may change programmatically it's value and text.
+  * Returns the "Select All" choice item. Use this property to change the item's `value` or `text`.
   */
   get selectAllItem(): ItemValue;
   /*
-  * Use this property to set the different text for Select All item.
+  * Gets or sets a caption for the "Select All" choice item.
   */
   get selectAllText(): string;
   set selectAllText(val: string);
   get locSelectAllText(): LocalizableString;
   /*
-  * Set this property to true, to show the "Select All" item on the top. If end-user checks this item, then all items are checked.
+  * Enable this property to display a "Select All" item. When users select it, all other choice items, except "Other" and "None", also become selected.
   */
+  get showSelectAllItem(): boolean;
+  set showSelectAllItem(val: boolean);
   get hasSelectAll(): boolean;
   set hasSelectAll(val: boolean);
   /*
-  * Returns true if all items are selected
+  * Returns `true` if all choice items, except "Other" and "None", are selected.
   */
   get isAllSelected(): boolean;
   set isAllSelected(val: boolean);
-  /*
-  * It will select all items, except other and none. If all items have been already selected then it will clear the value
-  */
   toggleSelectAll(): void;
   /*
-  * Select all items, except other and none.
+  * Selects all choice items, except "Other" and "None".
+  * 
+  * To clear selection, call the `clearValue()` method.
   */
   selectAll(): void;
+  protected isItemSelectedCore(item: ItemValue): boolean;
   /*
-  * Returns true if item is checked
-  */
-  isItemSelectedCore(item: ItemValue): boolean;
-  /*
-  * Set this property different to 0 to limit the number of selected choices in the checkbox.
+  * Sets a limit on the number of selected choices.
+  * 
+  * Default value: 0 (unlimited)
+  * 
+  * > NOTE: This property only limits the number of choice items that can be selected by users. You can select any number of choice items in code, regardless of the `maxSelectedChoices` value.
   */
   get maxSelectedChoices(): number;
   set maxSelectedChoices(val: number);
   /*
-  * Return the selected items in the checkbox. Returns empty array if the value is empty
+  * An array of selected choice items. Includes the "Other" and "None" choice items if they are selected, but not "Select All". Items are sorted in the order they were selected.
   */
+  get selectedChoices(): any;
   get selectedItems(): any;
   protected onEnableItemCallBack(item: ItemValue): boolean;
   protected onAfterRunItemsEnableCondition(): void;
@@ -9546,9 +9683,6 @@ export declare class QuestionCheckboxModel extends QuestionCheckboxBase {
   protected supportSelectAll(): boolean;
   protected addToVisibleChoices(items: any, isAddAll: boolean): void;
   protected isHeadChoice(item: ItemValue, question: QuestionSelectBase): boolean;
-  /*
-  * For internal use in SurveyJS Creator V2.
-  */
   isItemInList(item: ItemValue): boolean;
   protected getDisplayValueCore(keysAsText: boolean, value: any): any;
   protected clearIncorrectValuesCore(): void;
@@ -9878,6 +10012,7 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
   domNode: any;
   protected getDefaultItemComponent(): string;
   getType(): string;
+  getItemTabIndex(item: ItemValue): number;
   get rootClass(): string;
   protected getItemClassCore(item: ItemValue, options: any): string;
   protected isItemCurrentDropTarget(item: ItemValue): boolean;
@@ -9938,17 +10073,14 @@ export declare class QuestionTagboxModel extends QuestionCheckboxModel {
   */
   hideSelectedItems: boolean;
   /*
-  * The clean files button caption.
-  */
-  get cleanButtonCaption(): string;
-  set cleanButtonCaption(val: string);
-  get locCleanButtonCaption(): LocalizableString;
-  /*
   * A text displayed in the input field when it doesn't have a value.
   */
   get placeholder(): string;
   set placeholder(val: string);
   get locPlaceholder(): LocalizableString;
+  get cleanCaption(): string;
+  set cleanCaption(val: string);
+  get locCleanCaption(): LocalizableString;
   getType(): string;
   get popupModel(): any;
   getControlClass(): string;
@@ -9967,10 +10099,11 @@ export declare function doKey2ClickUp(evt: any, options?: IAttachKey2clickOption
 export declare function doKey2ClickDown(evt: any, options?: IAttachKey2clickOptions): void;
 export declare function sanitizeEditableContent(element: any): void;
 export declare function createDialogOptions(componentName: string, data: any, onApply: any, onCancel?: any, onHide?: any, onShow?: any, cssClass?: string, title?: string, displayMode?: "popup" | "overlay"): IDialogOptions;
-export declare function createPopupModalViewModel(options: IDialogOptions): PopupBaseViewModel;
 export declare function createDropdownActionModel(actionOptions: IAction, dropdownOptions: IActionDropdownPopupOptions, locOwner?: any): Action;
 export declare function createDropdownActionModelAdvanced(actionOptions: IAction, listOptions: IListModel, popupOptions?: IPopupOptionsBase, locOwner?: any): Action;
 export declare function getCurrecyCodes(): Array<any>;
+export declare function createPopupModalViewModel(options: IDialogOptions): PopupBaseViewModel;
+export declare function createPopupViewModel(model: any, targetElement: any): PopupBaseViewModel;
 export declare function checkLibraryVersion(ver: string, libraryName: string): void;
 export declare function showModal(componentName: string, data: any, onApply: any, onCancel?: any, cssClass?: string, title?: string, displayMode?: "popup" | "overlay"): void;
 export declare function showDialog(dialogOptions: any): void;
@@ -10033,6 +10166,10 @@ export declare var settings: {
   */
   defaultLocaleName: string,
   /*
+  * By default we do not store a value for a locale if it equals to "default" locale value
+  */
+  storeDuplicatedTranslations: boolean,
+  /*
   * Default row name for matrix (single choice)
   */
   matrixDefaultRowName: string,
@@ -10235,7 +10372,6 @@ export declare var defaultListCss: {
   emptyContainer: string,
   emptyText: string,
 };
-export declare var FOCUS_INPUT_SELECTOR: any;
 export declare var surveyCss: {
   currentType: string,
   getCss: any,
@@ -10629,6 +10765,7 @@ export declare var youtubeUrl: any;
 export declare var youtubeEmbed: any;
 export declare var defaultWidth: number;
 export declare var defaultHeight: number;
+export declare var FOCUS_INPUT_SELECTOR: any;
 export declare var Version: string;
 export declare var defaultBootstrapCss: {
   root: string,