survey-react 1.9.50 → 1.9.51

package/survey.react.d.ts

@@ -1,5 +1,5 @@
 /*
-* Type definition for Survey JavaScript library for React v1.9.50
+* Type definition for Survey JavaScript library for React v1.9.51
 * Copyright (c) 2015-2022 Devsoft Baltic OÜ  - https://surveyjs.io/
 * License: MIT (http://www.opensource.org/licenses/mit-license.php)
 */
@@ -819,7 +819,7 @@ export declare class Base {
   /*
   * Returns `true` if the object is included in a survey.
   * 
-  * This method may return `false`, for example, when you [create a survey model dynamically](https://surveyjs.io/form-library/documentation/design-survey-create-a-simple-survey#create-or-change-a-survey-model-dynamically).
+  * This property may return `false`, for example, when you [create a survey model dynamically](https://surveyjs.io/form-library/documentation/design-survey-create-a-simple-survey#create-or-change-a-survey-model-dynamically).
   */
   get inSurvey(): boolean;
   get bindings(): Bindings;
@@ -872,11 +872,6 @@ export declare class Base {
   get isEditingSurveyElement(): boolean;
   iteratePropertiesHash(func: (hash: any, key: any) => void): void;
   /*
-  * set property value and before check if new property value is correct by calling JsonProperty onSettingValue function
-  * If onSettingValue is not set in declaration, then this function works as `setPropertyValue`.
-  */
-  checkAndSetPropertyValue(name: string, val: any): void;
-  /*
   * Assigns a new value to a specified property.
   */
   setPropertyValue(name: string, val: any): void;
@@ -1130,6 +1125,12 @@ export declare class ExpressionRunnerBase {
   protected runCore(values: any, properties?: any): any;
   protected doOnComplete(res: any): void;
 }
+export declare class FileLoader {
+  constructor(fileQuestion: QuestionFileModel, callback: (status: string, files: any) => void);
+  loaded: any;
+  load(files: any): void;
+  dispose(): void;
+}
 export declare class FunctionFactory {
   static Instance: FunctionFactory;
   functionHash: any;
@@ -1422,11 +1423,13 @@ export declare class ResponsivityManager {
   separatorSize: number;
   separatorAddConst: number;
   paddingSizeConst: number;
+  dotsSizeConst: number;
   protected recalcMinDimensionConst: boolean;
   getComputedStyle: (elt: JSX.Element) => any;
   protected getDimensions(element: any): IDimensions;
   protected getAvailableSpace(): number;
   protected calcItemSize(item: any): number;
+  protected calcActionDimensions(currentAction: Action, item: any): void;
   dispose(): void;
 }
 export declare class Skeleton extends React.Component<any, any> {
@@ -2016,6 +2019,8 @@ export declare class DropdownListModel extends Base {
   protected getAvailableItems(): Array<Action>;
   protected createListModel(): ListModel;
   protected resetFilterString(): void;
+  protected onSetFilterString(): void;
+  setInputHasValue(newValue: boolean): void;
   searchEnabled: boolean;
   filterString: string;
   get popupModel(): any;
@@ -2714,6 +2719,7 @@ export declare class Popup extends SurveyElementBase<IPopupProps, any> {
 export declare class PopupBaseViewModel extends Base {
   constructor(model: any, targetElement?: any);
   targetElement: any;
+  isAutoScroll: boolean;
   prevActiveElement: any;
   scrollEventCallBack: any;
   top: string;
@@ -3314,6 +3320,7 @@ export declare class VerticalResponsivityManager extends ResponsivityManager {
   protected getDimensions(): IDimensions;
   protected getAvailableSpace(): number;
   protected calcItemSize(item: any): number;
+  protected calcActionDimensions(currentAction: Action, item: any): void;
 }
 export declare class WebRequestEmptyError extends SurveyError {
   constructor(text: string, errorOwner?: ISurveyErrorOwner);
@@ -3458,6 +3465,7 @@ export declare class DropdownMultiSelectListModel extends DropdownListModel {
   closeOnSelect: boolean;
   protected override: any;
   createListModel(): MultiSelectListModel;
+  protected onSetFilterString(): void;
   selectAllItems(): void;
   selectNoneItem(): void;
   selectItem(id: string): void;
@@ -3712,8 +3720,9 @@ export declare class SurveyElement extends SurveyElementCore implements ISurveyE
   * 
   * Possible values:
   * 
-  * - `"collapsed"` - The survey element displays only `title` and `description`.
-  * - `"expanded"` - The survey element is displayed in full.
+  * - `"default"` (default) - The survey element is displayed in full and cannot be collapsed in the UI.
+  * - `"expanded"` - The survey element is displayed in full and can be collapsed in the UI.
+  * - `"collapsed"` - The survey element displays only `title` and `description` and can be expanded in the UI.
   */
   get state(): string;
   set state(val: string);
@@ -3772,11 +3781,15 @@ export declare class SurveyElement extends SurveyElementCore implements ISurveyE
   get areInvisibleElementsShowing(): boolean;
   get isVisible(): boolean;
   /*
-  * Returns `true` if the survey element or its parent element is read-only.
+  * Returns `true` if the survey element or its parent element is read-only.
+  * 
+  * If you want to switch a survey element to the read-only state based on a condition, specify the [`enableIf`](https://surveyjs.io/form-library/documentation/question#enableIf) property. Refer to the following help topic for information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
   */
   get isReadOnly(): boolean;
   /*
-  * Makes the survey element read-only.
+  * Makes the survey element read-only.
+  * 
+  * If you want to switch a survey element to the read-only state based on a condition, specify the [`enableIf`](https://surveyjs.io/form-library/documentation/question#enableIf) property. Refer to the following help topic for information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
   */
   get readOnly(): boolean;
   set readOnly(val: boolean);
@@ -3813,7 +3826,7 @@ export declare class SurveyElement extends SurveyElementCore implements ISurveyE
   set errors(val: any);
   hasVisibleErrors: boolean;
   /*
-  * Returns `true` if the survey element or its child elements have a validation error.
+  * Returns `true` if the survey element or its child elements have validation errors.
   * 
   * This property contains the result of the most recent validation. This result may be outdated. Call the `hasErrors` method to get an up-to-date value.
   */
@@ -3843,7 +3856,14 @@ export declare class SurveyElement extends SurveyElementCore implements ISurveyE
   delete(): void;
   locOwner: ILocalizableOwner;
   /*
-  * Returns the survey's [locale](https://surveyjs.io/form-library/documentation/surveymodel#locale).
+  * Returns the survey's [locale](https://surveyjs.io/form-library/documentation/surveymodel#locale).
+  * 
+  * If a default locale is used, this method returns an empty string. To get the applied locale in this case, use the following code:
+  * 
+  * ```js
+  * import { surveyLocalization } from 'survey-core';
+  * const defaultLocale = surveyLocalization.defaultLocale;
+  * ```
   */
   getLocale(): string;
   getMarkdownHtml(text: string, name: string): string;
@@ -3927,7 +3947,7 @@ export declare class SurveyElementErrors extends ReactSurveyElement {
   protected renderElement(): JSX.Element;
 }
 /*
-* The `Survey` object contains information about the survey, Pages, Questions, flow logic and etc.
+* The `SurveyModel` object contains properties and methods that allow you to control the survey and access its elements.
 */
 export declare class SurveyModel extends SurveyElementCore implements ISurvey, ISurveyData, ISurveyImpl, ISurveyTriggerOwner, ISurveyErrorOwner, ISurveyTimerText {
   constructor(jsonObj?: any, renderedElement?: any);
@@ -3964,12 +3984,15 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   onCompleting: EventBase<SurveyModel>;
   /*
   * The event is fired after a user clicks the 'Complete' button and finishes a survey. Use this event to send the survey data to your web server.
+  * 
   * - `sender` - the survey object that fires the event.
   * - `options.showDataSaving(text)` - call this method to show that the survey is saving survey data on your server. The `text` is an optional parameter to show a custom message instead of default.
   * - `options.showDataSavingError(text)` - call this method to show that an error occurred while saving the data on your server. If you want to show a custom error, use an optional `text` parameter.
   * - `options.showDataSavingSuccess(text)` - call this method to show that the data was successfully saved on the server.
   * - `options.showDataSavingClear` - call this method to hide the text about the saving progress.
   * - `options.isCompleteOnTrigger` - returns true if the survey is completed on "complete" trigger.
+  * 
+  * > NOTE: Do not disable the [`showCompletedPage`](https://surveyjs.io/form-library/documentation/surveymodel#showCompletedPage) property if you call one of the `options.showDataSaving...` methods described above. This is required because the UI that indicates data saving progress is integrated into the Complete page. If you hide the Complete page, the UI also becomes invisible.
   */
   onComplete: EventBase<SurveyModel>;
   /*
@@ -5000,9 +5023,6 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   get questionTitlePattern(): string;
   set questionTitlePattern(val: string);
   getQuestionTitlePatternOptions(): Array<any>;
-  /*
-  * Gets or sets a question title template. Obsolete, please use questionTitlePattern
-  */
   get questionTitleTemplate(): string;
   set questionTitleTemplate(val: string);
   get locQuestionTitleTemplate(): LocalizableString;
@@ -5056,15 +5076,11 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   */
   get processedTitle(): string;
   /*
-  * Gets or sets the question title location.
-  * 
-  * The following options are available:
+  * Gets or sets question title location relative to the input field: `"top"`, `"bottom"`, or `"left"`.
   * 
-  * - `bottom` - show a question title to bottom
-  * - `left` - show a question title to left
-  * - `top` - show a question title to top.
+  * > NOTE: Certain question types (Matrix, Multiple Text) do not support the `"left"` value. For them, the `"top"` value is used.
   * 
-  * > Some questions, for example matrixes, do not support 'left' value. The title for them will be displayed to the top.
+  * You can override this setting if you specify the `questionTitleLocation` property for an [individual page](https://surveyjs.io/form-library/documentation/pagemodel#questionTitleLocation) or [panel](https://surveyjs.io/form-library/documentation/panelmodel#questionTitleLocation) or set the `titleLocation` property for a [specific question](https://surveyjs.io/form-library/documentation/question#titleLocation).
   */
   get questionTitleLocation(): string;
   set questionTitleLocation(val: string);
@@ -5117,11 +5133,11 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   get isEditingSurveyElement(): boolean;
   getAllValues(): any;
   /*
-  * Returns survey result data as an array of plain objects: with question `title`, `name`, `value`, and `displayValue`.
+  * Returns survey results as an array of objects in which the question name, title, value, and other parameters are stored as individual properties.
   * 
-  * For complex questions (like matrix, etc.) `isNode` flag is set to `true` and data contains array of nested objects (rows).
+  * If a question can have more than one value (Matrix, Multiple Text), its object enables the `isNode` flag and stores information about these values in the `data` property. Refer to the following help topic for more information: [Access Full Survey Results](https://surveyjs.io/form-library/documentation/handle-survey-results-access#access-full-survey-results).
   * 
-  * Set `options.includeEmpty` to `false` if you want to skip empty answers.
+  * If you want to skip empty answers, pass an object with the `includeEmpty` property set to `false`.
   */
   getPlainData(options?: any): any;
   getFilteredValues(): any;
@@ -5741,6 +5757,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   */
   get width(): string;
   set width(val: string);
+  get renderedWidth(): string;
   get timerInfoText(): string;
   get timerModel(): SurveyTimerModel;
   /*
@@ -6196,7 +6213,8 @@ export declare class UrlConditionItem extends ExpressionItem {
 }
 export declare class Variable extends Const {
   constructor(variableName: string);
-  static DisableConversionChar: string;
+  static get DisableConversionChar(): string;
+  static set DisableConversionChar(val: string);
   valueInfo: any;
   useValueAsItIs: boolean;
   getType(): string;
@@ -6525,10 +6543,13 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   protected isReadyValue: boolean;
   commentElement: any;
   /*
-  * The event is fired when isReady property of question is changed.
-  * options.question - the question
-  * options.isReady - current value of isReady
-  * options.oldIsReady - old value of isReady
+  * An event that is raised when the question's ready state has changed (expressions are evaluated, choices are loaded from a web resource specified by the `choicesByUrl` property, etc.).
+  * 
+  * Parameters:
+  * 
+  * - `sender` - A survey that contains the question whose ready state has changed.
+  * - `options.isReady` - A Boolean value that indicates whether the question is ready.
+  * - `options.oldIsReady` - A Boolean value that indicates the previous ready state.
   */
   onReadyChanged: EventBase<Question>;
   isReadOnlyRenderDiv(): boolean;
@@ -6537,29 +6558,21 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   getSurvey(live?: boolean): ISurvey;
   getValueName(): string;
   /*
-  * Use this property if you want to store the question result in the name different from the question name.
-  * Question name should be unique in the survey and valueName could be not unique. It allows to share data between several questions with the same valueName.
-  * The library set the value automatically if the question.name property is not valid. For example, if it contains the period '.' symbol.
-  * In this case if you set the question.name property to 'x.y' then the valueName becomes 'x y'.
-  * Please note, this property is hidden for questions without input, for example html question.
+  * Specifies an object property that should store the question value.
+  * 
+  * Refer to the [Merge Question Values](https://surveyjs.io/form-library/documentation/design-survey-merge-question-values) help topic for more information.
   */
   get valueName(): string;
   set valueName(val: string);
   protected onValueNameChanged(oldValue: string): void;
   protected onNameChanged(oldValue: string): void;
   get isReady(): boolean;
-  /*
-  * A11Y properties
-  */
   get ariaRequired(): "true" | "false";
   get ariaInvalid(): "true" | "false";
   get ariaDescribedBy(): string;
-  /*
-  * Get is question ready to use
-  */
   choicesLoaded(): void;
   /*
-  * Get/set the page where the question is located.
+  * Returns a page to which the question belongs and allows you to move this question to a different page.
   */
   get page(): IPage;
   set page(val: IPage);
@@ -6569,25 +6582,36 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   getLayoutType(): string;
   isLayoutTypeSupported(layoutType: string): boolean;
   /*
-  * Use it to get/set the question visibility.
+  * Gets or sets question visibility.
+  * 
+  * If you want to display or hide a question based on a condition, specify the [`visibleIf`](https://surveyjs.io/form-library/documentation/question#visibleIf) property. Refer to the following help topic for information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
   */
   get visible(): boolean;
   set visible(val: boolean);
   protected onVisibleChanged(): void;
   /*
-  * Use it to choose how other question values will be rendered in title if referenced in {}.
-  * Please note, this property is hidden for question without input, for example html question.
+  * 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.
+  * 
+  * Default value: `true`
   */
   get useDisplayValuesInTitle(): boolean;
   set useDisplayValuesInTitle(val: boolean);
   protected getUseDisplayValuesInTitle(): boolean;
   /*
-  * An expression that returns true or false. If it returns true the Question becomes visible and if it returns false the Question becomes invisible. The library runs the expression on survey start and on changing a question value. If the property is empty then visible property is used.
+  * A Boolean expression. If it evaluates to `false`, this question becomes hidden.
+  * 
+  * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
+  * 
+  * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility)
   */
   get visibleIf(): string;
   set visibleIf(val: string);
   /*
-  * Returns true if the question is visible or survey is in design mode right now.
+  * Returns `true` if the question is visible or the survey is currently in design mode.
+  * 
+  * If you want to display or hide a question based on a condition, specify the [`visibleIf`](https://surveyjs.io/form-library/documentation/question#visibleIf) property. Refer to the following help topic for information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
   */
   get isVisible(): boolean;
   /*
@@ -6596,12 +6620,14 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   */
   get visibleIndex(): number;
   /*
-  * Set hideNumber to true to stop showing the number for this question. The question will not be counter
+  * Hides the question number from the title and excludes the question from numbering.
+  * 
+  * If you want to disable question numbering in the entire survey, set SurveyModel's `showQuestionNumbers` property to `false`.
   */
   get hideNumber(): boolean;
   set hideNumber(val: boolean);
   /*
-  * Returns true if the question may have a title located on the left
+  * Returns `true` if the question can display its title to the left of the input field.
   */
   get isAllowTitleLeft(): boolean;
   /*
@@ -6630,40 +6656,48 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   */
   getType(): string;
   get isQuestion(): boolean;
-  /*
-  * Move question to a new container Page/Panel. Add as a last element if insertBefore parameter is not used or inserted into the given index,
-  * if insert parameter is number, or before the given element, if the insertBefore parameter is a question or panel
-  */
   moveTo(container: IPanel, insertBefore?: any): boolean;
   getProgressInfo(): IProgressInfo;
   setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
   /*
-  * A parent element. It can be panel or page.
+  * Returns a survey element (panel or page) that contains the question and allows you to move this question to a different survey element.
   */
   get parent(): IPanel;
   set parent(val: IPanel);
   parentQuestionValue: Question;
   /*
-  * A parent question. It can be a dynamic panel or dynamic/dropdown matrices. If the value is a matrix, it means that question is a cell question.
-  * This property is null for a stand alone question.
+  * A Dynamic Panel, Dynamic Matrix, or Dropdown Matrix that includes the current question.
+  * 
+  * This property is `null` for standalone questions.
   */
   get parentQuestion(): Question;
   setParentQuestion(val: Question): void;
   protected onParentQuestionChanged(): void;
   protected onParentChanged(): void;
   /*
-  * Returns false if the question doesn't have a title property, for example: QuestionHtmlModel, or titleLocation property equals to "hidden"
+  * Returns `false` if the `titleLocation` property is set to `"hidden"` or if the question cannot have a title (for example, an [HTML](https://surveyjs.io/form-library/documentation/questionhtmlmodel) question).
+  * 
+  * If the `title` property is `undefined` or set to an empty string, the `hasTitle` property returns `true`, because the question uses its `name` as a title in this case.
   */
   get hasTitle(): boolean;
   /*
-  * Set this property different from "default" to set the specific question title location for this panel/page.
-  * Please note, this property is hidden for questions without input, for example html question.
+  * Sets question title location relative to the input field. Overrides the `questionTitleLocation` property specified for the question's container (survey, page, or panel).
+  * 
+  * Possible values:
+  * 
+  * - `"default"` - Inherits the setting from the `questionTitleLocation` property specified for the question's container.
+  * - `"top"` - Displays the title above the input field.
+  * - `"bottom"` - Displays the title below the input field.
+  * - `"left"` - Displays the title to the left of the input field.
+  * - `"hidden"` - Hides the question title.
+  * 
+  * > NOTE: Certain question types (Matrix, Multiple Text) do not support the `"left"` value. For them, the `"top"` value is used.
   */
   get titleLocation(): string;
   set titleLocation(val: string);
   getTitleOwner(): ITitleOwner;
   /*
-  * Return the title location based on question titleLocation property and QuestionTitleLocation of it's parents
+  * Returns title location calculated based on the question's `titleLocation` property and the `questionTitleLocation` property of the question's containers (survey, page, or panel).
   */
   getTitleLocation(): string;
   protected getTitleLocationCore(): string;
@@ -6673,19 +6707,24 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   get hasTitleOnLeftTop(): boolean;
   get errorLocation(): string;
   /*
-  * Returns false if the question doesn't have an input element, for example: QuestionHtmlModel
+  * Returns `false` if the question has no input fields ([HTML](https://surveyjs.io/form-library/documentation/questionhtmlmodel), [Image](https://surveyjs.io/form-library/documentation/questionimagemodel), and similar question types).
   */
   get hasInput(): boolean;
   /*
-  * Returns false if the question doesn't have an input element or have multiple inputs: matrices or panel dynamic
+  * Returns `false` if the question has no input fields ([HTML](https://surveyjs.io/form-library/documentation/questionhtmlmodel), [Image](https://surveyjs.io/form-library/documentation/questionimagemodel)) or has multiple input fields ([Matrix](https://surveyjs.io/form-library/documentation/questionmatrixmodel), [Multiple Text](https://surveyjs.io/form-library/documentation/questionmultipletextmodel)).
   */
   get hasSingleInput(): boolean;
   get inputId(): string;
   protected getDefaultTitleValue(): string;
   protected getDefaultTitleTagName(): string;
   /*
-  * Question description location. By default, value is "default" and it depends on survey questionDescriptionLocation property
-  * You may change it to "underInput" to render it under question input or "underTitle" to rendered it under title.
+  * Specifies where to display a question description.
+  * 
+  * Possible values:
+  * 
+  * - `"default"` (default) - Inherits the setting from the Survey's [`questionDescriptionLocation`](https://surveyjs.io/form-library/documentation/surveymodel#questionDescriptionLocation) property.
+  * - `"underTitle"` - Displays the description under the question title.
+  * - `"underInput"` - Displays the description under the interactive area.
   */
   get descriptionLocation(): string;
   set descriptionLocation(val: string);
@@ -6694,33 +6733,28 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   protected needClickTitleFunction(): boolean;
   protected processTitleClick(): boolean;
   /*
-  * The custom text that will be shown on required error. Use this property, if you do not want to show the default text.
-  * Please note, this property is hidden for question without input, for example html question.
+  * Specifies a custom error message for a required form field.
   */
   get requiredErrorText(): string;
   set requiredErrorText(val: string);
   get locRequiredErrorText(): LocalizableString;
   /*
-  * Use it to get or set the comment value.
+  * Specifies a caption displayed above the comment area. Applies when the `hasComment` property is `true`.
   */
   get commentText(): string;
   set commentText(val: string);
   get locCommentText(): LocalizableString;
   /*
-  * Use this property to set the place holder text for comment field  .
+  * A placeholder for the comment area. Applies when the `hasComment` property is `true`.
   */
+  get commentPlaceholder(): string;
+  set commentPlaceholder(val: string);
+  get locCommentPlaceholder(): LocalizableString;
   get commentPlaceHolder(): string;
   set commentPlaceHolder(val: string);
-  get locCommentPlaceHolder(): LocalizableString;
-  get commentOrOtherPlaceHolder(): string;
-  /*
-  * Returns a copy of question errors survey. For some questions like matrix and panel dynamic it includes the errors of nested questions.
-  */
+  get commentOrOtherPlaceholder(): string;
   getAllErrors(): Array<SurveyError>;
   getErrorByType(errorType: string): SurveyError;
-  /*
-  * The link to the custom widget.
-  */
   get customWidget(): QuestionCustomWidget;
   updateCustomWidget(): void;
   localeChanged(): void;
@@ -6731,20 +6765,14 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   afterRenderQuestionElement(el: any): void;
   afterRender(el: any): void;
   beforeDestroyQuestionElement(el: any): void;
-  /*
-  * Returns the rendred question title.
-  */
   get processedTitle(): string;
-  /*
-  * Returns the title after processing the question template.
-  */
   get fullTitle(): string;
   protected get titlePattern(): string;
   get isRequireTextOnStart(): boolean;
   get isRequireTextBeforeTitle(): boolean;
   get isRequireTextAfterTitle(): boolean;
   /*
-  * The Question renders on the new line if the property is true. If the property is false, the question tries to render on the same line/row with a previous question/panel.
+  * Disable this property if you want to render the current question on the same line or row with the previous question or panel.
   */
   get startWithNewLine(): boolean;
   set startWithNewLine(val: boolean);
@@ -6781,7 +6809,7 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   protected getCssType(): string;
   get renderCssRoot(): string;
   /*
-  * Move the focus to the input of this question.
+  * Moves focus to the input field of this question.
   */
   focus(onError?: boolean): void;
   focusIn: any;
@@ -6795,33 +6823,33 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   supportComment(): boolean;
   supportOther(): boolean;
   /*
-  * Set this property to true, to make the question a required. If a user doesn't answer the question then a validation error will be generated.
-  * Please note, this property is hidden for question without input, for example html question.
+  * Makes the question required. If a respondent skips a required question, the survey displays a validation error.
   */
   get isRequired(): boolean;
   set isRequired(val: boolean);
   /*
-  * An expression that returns true or false. If it returns true the Question becomes required and an end-user has to answer it.
-  * If it returns false the Question then an end-user may not answer it the Question maybe empty.
-  * The library runs the expression on survey start and on changing a question value. If the property is empty then isRequired property is used.
-  * Please note, this property is hidden for question without input, for example html question.
+  * A Boolean expression. If it evaluates to `true`, this question becomes required.
+  * 
+  * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
+  * 
+  * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility)
   */
   get requiredIf(): string;
   set requiredIf(val: string);
   /*
-  * Set it to true, to add a comment for the question.
+  * Specifies whether to display a comment area. Incompatible with the `hasOther` property.
   */
   get hasComment(): boolean;
   set hasComment(val: boolean);
   /*
-  * The unique identificator. It is generated automatically.
+  * A value to assign to the `id` attribute of the rendered HTML element. A default `id` is generated automatically.
   */
   get id(): string;
   set id(val: string);
   get ariaTitleId(): string;
   get ariaRole(): string;
   /*
-  * Specifies whether to display the "Other" choice item.
+  * Specifies whether to display the "Other" choice item. Incompatible with the `hasComment` property.
   */
   get hasOther(): boolean;
   set hasOther(val: boolean);
@@ -6833,19 +6861,20 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   get renderedInputDisabled(): string;
   protected onReadOnlyChanged(): void;
   /*
-  * An expression that returns true or false. If it returns false the Question becomes read only and an end-user will not able to answer on the qustion. The library runs the expression on survey start and on changing a question value. If the property is empty then readOnly property is used.
-  * Please note, this property is hidden for question without input, for example html question.
+  * A Boolean expression. If it evaluates to `false`, this question 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.
+  * 
+  * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility)
   */
   get enableIf(): string;
   set enableIf(val: string);
   surveyChoiceItemVisibilityChange(): void;
-  /*
-  * Run visibleIf and enableIf expressions. If visibleIf or/and enabledIf are not empty, then the results of performing the expression (true or false) set to the visible/readOnly properties.
-  */
   runCondition(values: any, properties: any): void;
   /*
-  * The property returns the question number. If question is invisible then it returns empty string.
-  * If visibleIndex is 1, then no is 2, or 'B' if survey.questionStartIndex is 'A'.
+  * A question number or letter (depends on SurveyModel's `questionStartIndex` property).
+  * 
+  * For invisible questions, this property returns an empty string.
   */
   get no(): string;
   protected getStartIndex(): string;
@@ -6855,13 +6884,13 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   protected initCommentFromSurvey(): void;
   protected runExpression(expression: string): any;
   /*
-  * Get/Set the question value.
+  * Gets or sets the question value.
   */
   get value(): any;
   set value(val: any);
   get valueForSurvey(): any;
   /*
-  * Clear the question value. It clears the question comment as well.
+  * Sets the question's `value` and `comment` properties to `undefined`.
   */
   clearValue(): void;
   unbindValue(): void;
@@ -6869,32 +6898,32 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   protected getUnbindValue(value: any): any;
   protected isValueSurveyElement(val: any): boolean;
   /*
-  * Return true if there is a parent (page or panel) and it is visible
+  * Returns `true` if a parent element (page or panel) is visible.
   */
   get isParentVisible(): boolean;
   clearValueIfInvisible(reason?: string): void;
   protected clearValueIfInvisibleCore(): void;
   /*
-  * Gets or sets a value that specifies how invisible question clears the value. By default the behavior is define by Survey "clearInvisibleValues" property.
+  * Specifies when to clear the question value if the question becomes invisible.
   * 
-  * The following options are available:
+  * Possible values:
   * 
-  * - `default` (default) - Survey "clearInvisibleValues" property defines the behavior.
-  * - `none` - do not clear invisible value.
-  * - `onHidden` - clear the question value when it becomes invisible. If a question has value and it was invisible initially then survey clears the value on completing.
-  * - `onComplete` - clear invisible question value on survey complete.
+  * - `"default"` (default) - Inherits the setting from the Survey's [`clearInvisibleValues`](https://surveyjs.io/form-library/documentation/surveymodel#clearInvisibleValues) property.
+  * - `"onHidden"` - Clears the value when the question becomes invisible. If a question is invisible on startup and has an initial value, this value will be cleared when the survey is complete.
+  * - `"onComplete"` - Clears the value when the survey is complete.
+  * - `"none"` - Never clears the value of an invisible question.
   */
   get clearIfInvisible(): string;
   set clearIfInvisible(val: string);
   get displayValue(): any;
   /*
-  * Return the question value as a display text. For example, for dropdown, it would return the item text instead of item value.
+  * Returns a display text that corresponds to the question value. For example, if you call this method for a Dropdown question, it returns an item text instead of an item value.
   */
   getDisplayValue(keysAsText: boolean, value?: any): any;
   protected getDisplayValueCore(keyAsText: boolean, value: any): any;
   protected getDisplayValueEmpty(): string;
   /*
-  * A default value for the question. Ignored for question types that cannot have a [value](https://surveyjs.io/Documentation/Library?id=Question#value) (for example, HTML).
+  * A default value for the question. Ignored for question types that cannot have a [value](https://surveyjs.io/form-library/documentation/question#value) (for example, HTML).
   * 
   * The default value is used as a question value in the following cases:
   * 
@@ -6905,9 +6934,9 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   get defaultValue(): any;
   set defaultValue(val: any);
   /*
-  * An expression used to calculate the [defaultValue](https://surveyjs.io/Documentation/Library?id=Question#defaultValue).
+  * An expression used to calculate the [defaultValue](https://surveyjs.io/form-library/documentation/question#defaultValue).
   * 
-  * This expression applies until the question [value](https://surveyjs.io/Documentation/Library?id=Question#value) is specified by an end user or programmatically.
+  * This expression applies until the question [value](https://surveyjs.io/form-library/documentation/question#value) is specified by an end user or programmatically.
   * 
   * An expression can reference other questions as follows:
   * 
@@ -6915,26 +6944,27 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   * - `{panel.other_question_name}` (to access questions inside the same dynamic panel)
   * - `{row.other_question_name}` (to access questions inside the same dynamic matrix or multi-column dropdown)
   * 
-  * An expression can also include built-in and custom functions for advanced calculations. For example, if the `defaultValue` should be today's date, set the `defaultValueExpression` to `"today()"`, and the corresponding built-in function will be executed each time the survey is loaded. Refer to the following help topic for more information: [Use Functions in Expressions](https://surveyjs.io/Documentation/Library#conditions-functions).
+  * An expression can also include built-in and custom functions for advanced calculations. For example, if the `defaultValue` should be today's date, set the `defaultValueExpression` to `"today()"`, and the corresponding built-in function will be executed each time the survey is loaded. Refer to the following help topic for more information: [Built-In Functions](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#built-in-functions).
   */
   get defaultValueExpression(): any;
   set defaultValueExpression(val: any);
   get resizeStyle(): "none" | "both";
   /*
-  * Returns question answer data as a plain object: with question title, name, value and displayValue.
-  * For complex questions (like matrix, etc.) isNode flag is set to true and data contains array of nested objects (rows)
-  * set options.includeEmpty to false if you want to skip empty answers
+  * Returns the question value as an object in which the question name, title, value, and other parameters are stored as individual properties.
+  * 
+  * If the question can have more than one value (Matrix, Multiple Text), the object enables the `isNode` flag and stores information about these values in the `data` property. Refer to the following help topic for more information: [Access Full Survey Results](https://surveyjs.io/form-library/documentation/handle-survey-results-access#access-full-survey-results).
+  * 
+  * Pass an object with the `includeEmpty` property set to `false` if you want to skip empty answers.
   */
   getPlainData(options?: any): any;
   /*
-  * The correct answer on the question. Set this value if you are doing a quiz.
-  * Please note, this property is hidden for question without input, for example html question.
+  * 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).
   */
   get correctAnswer(): any;
   set correctAnswer(val: any);
   protected convertDefaultValue(val: any): any;
   /*
-  * Returns questions count: 1 for the non-matrix questions and all inner visible questions that has input(s) widgets for question of matrix types.
+  * The number of quiz questions. A question counts if it is visible, has an input field, and specifies `correctAnswer`.
   */
   get quizQuestionCount(): number;
   get correctAnswerCount(): number;
@@ -6951,14 +6981,14 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   protected isValueExpression(val: any): boolean;
   protected setValueAndRunExpression(runner: ExpressionRunner, defaultValue: any, setFunc: (val: any) => void, values?: any, properties?: any): void;
   /*
-  * The question comment value.
+  * A comment to the selected question value. Enable the `hasComment` property to allow users to leave comments.
   */
   get comment(): string;
   set comment(val: string);
   protected getQuestionComment(): string;
   protected setQuestionComment(newValue: string): void;
   /*
-  * Returns true if the question value is empty
+  * Returns `true` if the question value is an empty string, array, or object or if it equals `undefined` or `null`.
   */
   isEmpty(): boolean;
   get isAnswered(): boolean;
@@ -6966,8 +6996,7 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   protected updateIsAnswered(): void;
   protected getIsAnswered(): boolean;
   /*
-  * The list of question validators.
-  * Please note, this property is hidden for question without input, for example html question.
+  * Question validators.
   */
   get validators(): any;
   set validators(val: any);
@@ -6979,21 +7008,12 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   * Returns true if there is a validation error(s) in the question.
   */
   hasErrors(fireCallback?: boolean, rec?: any): boolean;
-  /*
-  * Returns the validation errors count.
-  */
   get currentErrorCount(): number;
   /*
-  * Returns the char/string for a required question.
+  * Returns a character or text string that indicates a required question.
   */
   get requiredText(): string;
-  /*
-  * Add error into the question error list.
-  */
   addError(error: string | SurveyError): void;
-  /*
-  * Remove a particular error from the question error list.
-  */
   removeError(error: SurveyError): void;
   protected canCollectErrors(): boolean;
   protected canRunValidators(isOnValueChanged: boolean): boolean;
@@ -7030,13 +7050,16 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   supportGoNextPageAutomatic(): boolean;
   supportGoNextPageError(): boolean;
   /*
-  * Call this function to remove values from the current question, that end-user will not be able to enter.
-  * For example the value that doesn't exists in a radigroup/dropdown/checkbox choices or matrix rows/columns.
+  * Removes values that cannot be assigned to this question, for example, choices unlisted in the `choices` array.
+  * 
+  * Call this method after you assign new question values in code to ensure that they are acceptable.
+  * 
+  * > NOTE: This method does not remove values that do not pass validation. Call the `hasErrors()` method to validate newly assigned values.
   */
   clearIncorrectValues(): void;
   clearOnDeletingContainer(): void;
   /*
-  * Call this function to clear all errors in the question
+  * Empties the `errors` array.
   */
   clearErrors(): void;
   clearUnusedValues(): void;
@@ -7359,10 +7382,6 @@ export declare class PanelModel extends PanelModelBase implements IElement {
   get page(): IPage;
   set page(val: IPage);
   delete(): void;
-  /*
-  * Move panel to a new container Page/Panel. Add as a last element if insertBefore parameter is not used or inserted into the given index,
-  * if insert parameter is number, or before the given element, if the insertBefore parameter is a question or panel
-  */
   moveTo(container: IPanel, insertBefore?: any): boolean;
   /*
   * Returns the visible index of the panel in the survey. Commonly it is -1 and it doesn't show.
@@ -7772,6 +7791,7 @@ 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;
@@ -8305,7 +8325,16 @@ export declare class QuestionRatingModel extends Question {
   * 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.
   */
   displayRateDescriptionsAsExtremeItems: boolean;
-  useDropdown: "auto" | "always" | "never";
+  /*
+  * Specifies how a Rating question displays rate values.
+  * 
+  * Possible values:
+  * 
+  * - `"buttons"` - Displays rate values as buttons in a row.
+  * - `"dropdown"` - Displays rate values as items in a drop-down list.
+  * - `"auto"` (default) - Selects between the `"buttons"` and `"dropdown"` modes based on the available width. When the width is insufficient to display buttons, the question displays a dropdown.
+  */
+  displayMode: "dropdown" | "auto" | "buttons";
   protected valueToData(val: any): any;
   /*
   * Click value again to clear.
@@ -8484,9 +8513,11 @@ export declare class QuestionSelectBase extends Question {
   /*
   * Use this property to set the place holder text for other or comment field  .
   */
+  get otherPlaceholder(): string;
+  set otherPlaceholder(val: string);
+  get locOtherPlaceholder(): LocalizableString;
   get otherPlaceHolder(): string;
   set otherPlaceHolder(val: string);
-  get locOtherPlaceHolder(): LocalizableString;
   /*
   * The text that shows when the other item is choosed by the other input is empty.
   */
@@ -8856,6 +8887,8 @@ export declare class QuestionCustomModel extends QuestionCustomModelBase {
 export declare class QuestionDropdownModel extends QuestionSelectBase {
   constructor(name: string);
   dropdownListModel: DropdownListModel;
+  updateReadOnlyText(): void;
+  locStrsChanged(): void;
   get showOptionsCaption(): boolean;
   set showOptionsCaption(val: boolean);
   get optionsCaption(): string;
@@ -8910,8 +8943,10 @@ export declare class QuestionDropdownModel extends QuestionSelectBase {
   get cleanButtonCaption(): string;
   set cleanButtonCaption(val: string);
   get locCleanButtonCaption(): LocalizableString;
+  inputHasValue: boolean;
+  readOnlyText: string;
   getControlClass(): string;
-  get readOnlyText(): string;
+  get selectedItemLocText(): LocalizableString;
   get popupModel(): any;
   onOpened: EventBase<QuestionDropdownModel>;
   onOpenedCallBack(): void;
@@ -9945,6 +9980,7 @@ export declare var settings: {
     trimStrings: boolean,
     caseSensitive: boolean,
   },
+  expressionDisableConversionChar: string,
   /*
   * Set this value to false, if you want to have UTC fuctions, for example setUTCHours inside our functions, like today.
   * By default it uses setHours function, with local date
@@ -10042,6 +10078,10 @@ export declare var settings: {
   */
   executeCompleteTriggerOnValueChanged: boolean,
   /*
+  * Set this property to false to stop showing "Compete" button when the complete trigger is going to be executed.
+  */
+  changeNavigationButtonsOnCompleteTrigger: boolean,
+  /*
   * Set this property to false to execute the skip trigger on next page instead of on value change.
   */
   executeSkipTriggerOnValueChanged: boolean,