survey-react 1.9.103 → 1.9.105

package/survey.react.d.ts

@@ -17,7 +17,7 @@ declare module "helpers" {
         static getUnbindValue(value: any): any;
         static createCopy(obj: any): any;
         static isConvertibleToNumber(value: any): boolean;
-        static isValueObject(val: any): boolean;
+        static isValueObject(val: any, excludeArray?: boolean): boolean;
         static isNumber(value: any): boolean;
         static getNumber(value: any): number;
         private static prepareStringToNumber;
@@ -994,8 +994,9 @@ declare module "utils/cssClassBuilder" {
 declare module "utils/utils" {
     function compareVersions(a: any, b: any): number;
     function confirmAction(message: string): boolean;
+    function confirmActionAsync(message: string, funcOnYes: () => void, funcOnNo?: () => void): void;
     function detectIEBrowser(): boolean;
-    function detectIEOrEdge(): any;
+    function detectIEOrEdge(): boolean;
     function loadFileFromBase64(b64Data: string, fileName: string): void;
     function isMobile(): boolean;
     const isShadowDOM: (rootElement: Document | ShadowRoot | HTMLElement) => rootElement is ShadowRoot;
@@ -1032,7 +1033,7 @@ declare module "utils/utils" {
         log(action: string): void;
         get result(): string;
     }
-    export { mergeValues, getElementWidth, isContainerVisible, classesToSelector, compareVersions, confirmAction, detectIEOrEdge, detectIEBrowser, loadFileFromBase64, isMobile, isShadowDOM, getElement, isElementVisible, findScrollableParent, scrollElementByChildId, navigateToUrl, createSvg, getIconNameFromProxy, increaseHeightByContent, getOriginalEvent, preventDefaults, findParentByClassNames, getFirstVisibleChild, };
+    export { mergeValues, getElementWidth, isContainerVisible, classesToSelector, compareVersions, confirmAction, confirmActionAsync, detectIEOrEdge, detectIEBrowser, loadFileFromBase64, isMobile, isShadowDOM, getElement, isElementVisible, findScrollableParent, scrollElementByChildId, navigateToUrl, createSvg, getIconNameFromProxy, increaseHeightByContent, getOriginalEvent, preventDefaults, findParentByClassNames, getFirstVisibleChild, };
 }
 declare module "actions/container" {
     import { Base } from "base";
@@ -1155,6 +1156,7 @@ declare module "list" {
         private onFilterStringChanged;
         private scrollToItem;
         constructor(items: Array<IAction>, onSelectionChanged: (item: T, ...params: any[]) => void, allowSelection: boolean, selectedItem?: IAction, onFilterStringChangedCallback?: (text: string) => void, elementId?: string);
+        setOnFilterStringChangedCallback(callback: (text: string) => void): void;
         setItems(items: Array<IAction>, sortByVisibleIndex?: boolean): void;
         protected onSet(): void;
         protected getDefaultCssClasses(): {
@@ -1326,7 +1328,7 @@ declare module "actions/action" {
          * The action item's icon size in pixels.
          * @see iconName
          */
-        iconSize?: number;
+        iconSize?: number | string;
         /**
          * The action item's location in a matrix question's row.
          *
@@ -1927,6 +1929,7 @@ declare module "defaultCss/defaultV2Css" {
             mainRoot: string;
             tableWrapper: string;
             root: string;
+            noHeader: string;
             rootVerticalAlignTop: string;
             rootVerticalAlignMiddle: string;
             rootAlternateRows: string;
@@ -1953,6 +1956,7 @@ declare module "defaultCss/defaultV2Css" {
             mainRoot: string;
             rootScroll: string;
             root: string;
+            noHeader: string;
             rootVerticalAlignTop: string;
             rootVerticalAlignMiddle: string;
             tableWrapper: string;
@@ -1965,6 +1969,7 @@ declare module "defaultCss/defaultV2Css" {
             row: string;
             headerCell: string;
             rowTextCell: string;
+            columnTitleCell: string;
             cellRequiredText: string;
             detailButton: string;
             detailButtonExpanded: string;
@@ -1972,7 +1977,9 @@ declare module "defaultCss/defaultV2Css" {
             detailIconExpanded: string;
             detailIconId: string;
             detailIconExpandedId: string;
+            detailPanelCell: string;
             actionsCell: string;
+            actionsCellDrag: string;
             emptyCell: string;
             verticalCell: string;
             cellQuestionWrapper: string;
@@ -1983,6 +1990,7 @@ declare module "defaultCss/defaultV2Css" {
             rootScroll: string;
             empty: string;
             root: string;
+            noHeader: string;
             tableWrapper: string;
             content: string;
             cell: string;
@@ -1990,6 +1998,7 @@ declare module "defaultCss/defaultV2Css" {
             itemCell: string;
             headerCell: string;
             rowTextCell: string;
+            columnTitleCell: string;
             cellRequiredText: string;
             button: string;
             detailRow: string;
@@ -2001,6 +2010,7 @@ declare module "defaultCss/defaultV2Css" {
             detailIconExpandedId: string;
             detailPanelCell: string;
             actionsCell: string;
+            actionsCellDrag: string;
             buttonAdd: string;
             buttonRemove: string;
             iconAdd: string;
@@ -2116,6 +2126,8 @@ declare module "defaultCss/defaultV2Css" {
             small: string;
             controls: string;
             placeholder: string;
+            canvas: string;
+            backgroundImage: string;
             clearButton: string;
             clearButtonIconId: string;
         };
@@ -2276,6 +2288,7 @@ declare module "trigger" {
         protected isExecutingOnNextPage: boolean;
         checkExpression(isOnNextPage: boolean, isOnComplete: boolean, keys: any, values: HashTable<any>, properties?: HashTable<any>): void;
         check(value: any): void;
+        get requireValidQuestion(): boolean;
         private perform;
         private triggerResult;
         protected onSuccess(values: HashTable<any>, properties: HashTable<any>): void;
@@ -2331,6 +2344,7 @@ declare module "trigger" {
     export class SurveyTriggerComplete extends SurveyTrigger {
         constructor();
         getType(): string;
+        get requireValidQuestion(): boolean;
         protected isRealExecution(): boolean;
         protected onSuccess(values: HashTable<any>, properties: HashTable<any>): void;
         protected onFailure(): void;
@@ -2357,6 +2371,7 @@ declare module "trigger" {
     export class SurveyTriggerSkip extends SurveyTrigger {
         constructor();
         getType(): string;
+        get requireValidQuestion(): boolean;
         get gotoName(): string;
         set gotoName(val: string);
         protected canBeExecuted(isOnNextPage: boolean): boolean;
@@ -2641,7 +2656,7 @@ declare module "panel" {
         endLoadingFromJson(): void;
         showTitle: boolean;
         get hasTitle(): boolean;
-        delete(): void;
+        delete(doDispose?: boolean): void;
         protected removeFromParent(): void;
         protected canShowTitle(): boolean;
         showDescription: boolean;
@@ -2973,6 +2988,20 @@ declare module "panel" {
         get hasDescriptionUnderTitle(): boolean;
         get cssHeader(): string;
         get cssDescription(): string;
+        /**
+         * Specifies the error message position for questions that belong to this page/panel.
+         *
+         * Use this property to override the [`questionErrorLocation`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#questionErrorLocation) property specified for the survey. You can also set the [`errorLocation`](https://surveyjs.io/form-library/documentation/question#errorLocation) property for individual questions.
+         *
+         * Possible values:
+         *
+         * - `"default"` (default) - Inherits the setting from the `questionErrorLocation` property specified for the survey.
+         * - `"top"` - Displays error messages above questions.
+         * - `"bottom"` - Displays error messages below questions.
+         */
+        get questionErrorLocation(): string;
+        set questionErrorLocation(val: string);
+        getQuestionErrorLocation(): string;
         get no(): string;
         dispose(): void;
     }
@@ -3103,13 +3132,14 @@ declare module "panel" {
     }
 }
 declare module "question_file" {
-    import { Question } from "question";
+    import { IPlainDataOptions } from "base-interfaces";
+    import { IQuestionPlainData, Question } from "question";
     import { EventBase } from "base";
     import { SurveyError } from "survey-error";
     import { ActionContainer } from "actions/container";
     import { Action } from "actions/action";
     /**
-     * A class that describes the File question type.
+     * A class that describes the File Upload question type.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/file-upload/ (linkStyle))
      */
@@ -3225,6 +3255,8 @@ declare module "question_file" {
         loadingFileTitle: string;
         chooseFileTitle: string;
         dragAreaPlaceholder: string;
+        renderedPlaceholderValue: string;
+        get renderedPlaceholder(): string;
         get inputTitle(): string;
         get chooseButtonText(): string;
         clear(doneCallback?: () => void): void;
@@ -3249,12 +3281,7 @@ declare module "question_file" {
         protected stateChanged(state: string): void;
         private allFilesOk;
         private isFileImage;
-        getPlainData(options?: {
-            includeEmpty?: boolean;
-            calculations?: Array<{
-                propertyName: string;
-            }>;
-        }): import("question").IQuestionPlainData;
+        getPlainData(options?: IPlainDataOptions): IQuestionPlainData;
         getChooseFileCss(): string;
         getReadOnlyFileCss(): string;
         get fileRootCss(): string;
@@ -3271,7 +3298,9 @@ declare module "question_file" {
         onDragLeave: (event: any) => void;
         doChange: (event: any) => void;
         doClean: (event: any) => void;
+        private clearFilesCore;
         doRemoveFile(data: any): void;
+        private removeFileCore;
         doDownloadFile: (event: any, data: any) => void;
     }
     export class FileLoader {
@@ -3455,14 +3484,14 @@ declare module "choicesRestful" {
 }
 declare module "question_baseselect" {
     import { SurveyError } from "survey-error";
-    import { ISurveyImpl, ISurvey, ISurveyData } from "base-interfaces";
-    import { Question } from "question";
+    import { ISurveyImpl, ISurvey, ISurveyData, IPlainDataOptions } from "base-interfaces";
+    import { IQuestionPlainData, Question } from "question";
     import { ItemValue } from "itemvalue";
     import { ChoicesRestful } from "choicesRestful";
     import { LocalizableString } from "localizablestring";
     import { HashTable } from "helpers";
     /**
-     * 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.).
+     * A base class for multiple-choice question types ([Checkboxes](https://surveyjs.io/form-library/documentation/questioncheckboxmodel), [Dropdown](https://surveyjs.io/form-library/documentation/questiondropdownmodel), [Radio Button Group](https://surveyjs.io/form-library/documentation/questionradiogroupmodel), etc.).
      */
     export class QuestionSelectBase extends Question {
         visibleChoicesChangedCallback: () => void;
@@ -3649,11 +3678,11 @@ declare module "question_baseselect" {
         get choices(): Array<any>;
         set choices(newValue: Array<any>);
         /**
-         * Inherits choice items from a specified question. Accepts a question name.
+         * Copies 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.
+         * If you specify this property, the `choices`, `choicesVisibleIf`, `choicesEnableIf`, and `choicesOrder` properties do not apply because their values are copied.
          *
-         * In addition, you can specify the `choicesFromQuestionMode` property if you do not want to inherit all choice items.
+         * In addition, you can specify the `choicesFromQuestionMode` property if you do not want to copy all choice items.
          * @see choicesFromQuestionMode
          * @see choices
          */
@@ -3661,22 +3690,32 @@ declare module "question_baseselect" {
         set choicesFromQuestion(val: string);
         private isLockVisibleChoices;
         /**
-         * Specifies which choice items to inherit from another question. Applies only when the `choicesFromQuestion` property is specified.
+         * Specifies which choice items to copy 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.
+         * - `"all"` (default) - Copies all choice items.
+         * - `"selected"` - Copies only selected choice items.
+         * - `"unselected"` - Copies only unselected choice items.
          *
-         * Use the `visibleChoices` property to access inherited choice items.
+         * Use the `visibleChoices` property to access copied choice items.
          * @see choicesFromQuestion
          * @see visibleChoices
          */
         get choicesFromQuestionMode(): string;
         set choicesFromQuestionMode(val: string);
+        /**
+         * Specifies which matrix column or dynamic panel question supplies choice values. Use this property to construct choice items based on cell values in Dynamic Matrix and question values in Dynamic Panel.
+         *
+         * Each choice item consists of a value saved in survey results and a text displayed in the UI. To construct a choice item, assign the `name` of a Dynamic Matrix or Dynamic Panel to the [`choicesFromQuestion`](#choicesFromQuestion) property and specify which dynamic panel question or matrix column supplies values and which provides texts. Use the `choiceValuesFromQuestion` and [`choiceTextsFromQuestion`](#choiceTextsFromQuestion) properties for this purpose. If a choice text is empty, a choice value is used as a display text and saved in survey results.
+         */
         get choiceValuesFromQuestion(): string;
         set choiceValuesFromQuestion(val: string);
+        /**
+         * Specifies which matrix column or dynamic panel question supplies choice texts. Use this property to construct choice items based on cell values in Dynamic Matrix and question values in Dynamic Panel.
+         *
+         * Each choice item consists of a value saved in survey results and a text displayed in the UI. To construct a choice item, assign the `name` of a Dynamic Matrix or Dynamic Panel to the [`choicesFromQuestion`](#choicesFromQuestion) property and specify which dynamic panel question or matrix column supplies values and which provides texts. Use the [`choiceValuesFromQuestion`](#choiceValuesFromQuestion) and `choiceTextsFromQuestion` properties for this purpose. If a choice text is empty, a choice value is used as a display text and saved in survey results.
+         */
         get choiceTextsFromQuestion(): string;
         set choiceTextsFromQuestion(val: string);
         /**
@@ -3764,16 +3803,10 @@ declare module "question_baseselect" {
         protected canShowOptionItem(item: ItemValue, isAddAll: boolean, hasItem: boolean): boolean;
         isItemInList(item: ItemValue): boolean;
         protected get isAddDefaultItems(): boolean;
-        getPlainData(options?: {
-            includeEmpty?: boolean;
-            includeQuestionTypes?: boolean;
-            calculations?: Array<{
-                propertyName: string;
-            }>;
-        }): import("question").IQuestionPlainData;
+        getPlainData(options?: IPlainDataOptions): IQuestionPlainData;
         protected getDisplayValueCore(keysAsText: boolean, value: any): any;
         protected getDisplayValueEmpty(): string;
-        protected getChoicesDisplayValue(items: ItemValue[], val: any): any;
+        private getChoicesDisplayValue;
         protected getDisplayArrayValue(keysAsText: boolean, value: any, onGetValueCallback?: (index: number) => any): string;
         private getItemDisplayValue;
         private getFilteredChoices;
@@ -4199,6 +4232,7 @@ declare module "question_matrixdropdowncolumn" {
         private indexValue;
         private _isVisible;
         private _hasVisibleCell;
+        private _visiblechoices;
         constructor(name: string, title?: string);
         getOriginalObj(): Base;
         getClassNameProperty(): string;
@@ -4221,6 +4255,10 @@ declare module "question_matrixdropdowncolumn" {
         setIsVisible(newVal: boolean): void;
         get hasVisibleCell(): boolean;
         set hasVisibleCell(newVal: boolean);
+        getVisibleMultipleChoices(): Array<ItemValue>;
+        get getVisibleChoicesInCell(): Array<any>;
+        setVisibleChoicesInCell(val: Array<any>): void;
+        get isFilteredMultipleColumns(): boolean;
         get name(): string;
         set name(val: string);
         get title(): string;
@@ -4329,7 +4367,7 @@ declare module "dragdrop/dom-adapter" {
     }
     export class DragDropDOMAdapter implements IDragDropDOMAdapter {
         private dd;
-        private longTap?;
+        private longTap;
         static PreventScrolling: boolean;
         private timeoutID;
         private startX;
@@ -4485,6 +4523,7 @@ declare module "question_matrixdropdownrendered" {
         get headers(): string;
         getTitle(): string;
         calculateFinalClassName(matrixCssClasses: any): string;
+        focusIn(): void;
     }
     export class QuestionMatrixDropdownRenderedRow extends Base {
         cssClasses: any;
@@ -4796,6 +4835,7 @@ declare module "question_matrixdynamic" {
          * @param confirmDelete *Optional.* A Boolean value that specifies whether to display a confirmation dialog. If you do not specify this parameter, the [`confirmDelete`](https://surveyjs.io/form-library/documentation/api-reference/dynamic-matrix-table-question-model#confirmDelete) property value is used.
          */
         removeRow(index: number, confirmDelete?: boolean): void;
+        private removeRowAsync;
         private removeRowCore;
         /**
          * A message displayed in a confirmation dialog that appears when a respondent wants to delete a row.
@@ -4920,9 +4960,9 @@ declare module "textPreProcessor" {
 }
 declare module "question_paneldynamic" {
     import { HashTable } from "helpers";
-    import { IElement, IQuestion, IPanel, ISurveyData, ISurvey, ISurveyImpl, ITextProcessor, IProgressInfo } from "base-interfaces";
+    import { IElement, IQuestion, IPanel, ISurveyData, ISurvey, ISurveyImpl, ITextProcessor, IProgressInfo, IPlainDataOptions } from "base-interfaces";
     import { LocalizableString } from "localizablestring";
-    import { Question, IConditionObject } from "question";
+    import { Question, IConditionObject, IQuestionPlainData } from "question";
     import { PanelModel } from "panel";
     import { SurveyError } from "survey-error";
     import { ActionContainer } from "actions/container";
@@ -4984,7 +5024,9 @@ declare module "question_paneldynamic" {
         panelCountChangedCallback: () => void;
         currentIndexChangedCallback: () => void;
         constructor(name: string);
+        get isCompositeQuestion(): boolean;
         get hasSingleInput(): boolean;
+        get isContainer(): boolean;
         getFirstQuestionToFocus(withError: boolean): Question;
         setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
         private assignOnPropertyChangedToTemplate;
@@ -4992,7 +5034,6 @@ declare module "question_paneldynamic" {
         private onTemplateElementPropertyChanged;
         private get useTemplatePanel();
         getType(): string;
-        get isCompositeQuestion(): boolean;
         clearOnDeletingContainer(): void;
         get isAllowTitleLeft(): boolean;
         removeElement(element: IElement): boolean;
@@ -5278,6 +5319,17 @@ declare module "question_paneldynamic" {
          */
         get templateTitleLocation(): string;
         set templateTitleLocation(value: string);
+        /**
+         * Specifies the error message position.
+         *
+         * Possible values:
+         *
+         * - `"default"` (default) - Inherits the setting from the [`errorLocation`](#errorLocation) property.
+         * - `"top"` - Displays error messages above questions.
+         * - `"bottom"` - Displays error messages below questions.
+         */
+        get templateErrorLocation(): string;
+        set templateErrorLocation(value: string);
         /**
          * Use this property to show/hide the numbers in titles in questions inside a dynamic panel.
          * By default the value is "off". You may set it to "onPanel" and the first question inside a dynamic panel will start with 1 or "onSurvey" to include nested questions in dymamic panels into global survey question numbering.
@@ -5459,6 +5511,7 @@ declare module "question_paneldynamic" {
         protected createNewPanel(): PanelModel;
         protected createAndSetupNewPanelObject(): PanelModel;
         private getTemplateQuestionTitleLocation;
+        getChildErrorLocation(child: Question): string;
         protected createNewPanelObject(): PanelModel;
         private settingPanelCountBasedOnValue;
         private setPanelCountBasedOnValue;
@@ -5478,12 +5531,7 @@ declare module "question_paneldynamic" {
         private static maxCheckCount;
         setPanelItemData(item: ISurveyData, name: string, val: any): void;
         getRootData(): ISurveyData;
-        getPlainData(options?: {
-            includeEmpty?: boolean;
-            calculations?: Array<{
-                propertyName: string;
-            }>;
-        }): import("question").IQuestionPlainData;
+        getPlainData(options?: IPlainDataOptions): IQuestionPlainData;
         updateElementCss(reNew?: boolean): void;
         get progressText(): string;
         get progress(): string;
@@ -5619,9 +5667,12 @@ declare module "survey-events-api" {
     }
     export interface CompleteBaseEvent {
         /**
-         * Returns `true` if survey completion is caused by the ["complete" trigger](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#complete).
+         * Returns `true` if survey completion is caused by a ["complete" trigger](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#complete).
          */
         isCompleteOnTrigger: boolean;
+        /**
+         * A "complete" trigger that has been executed. This parameter has a value only if `options.isCompleteOnTrigger` is `true`.
+         */
         completeTrigger?: Trigger;
     }
     export interface CompletingEvent extends CompleteBaseEvent {
@@ -5926,23 +5977,23 @@ declare module "survey-events-api" {
     }
     export interface ProgressTextEvent {
         /**
-         * a number of required questions that have input(s) and an user has answered
+         * The number of questions with input fields. [Image](https://surveyjs.io/form-library/examples/add-image-and-video-to-survey/), [HTML](https://surveyjs.io/form-library/examples/questiontype-html/), and [Expression](https://surveyjs.io/form-library/examples/questiontype-expression/) questions are not counted.
          */
-        requiredAnsweredQuestionCount: number;
+        questionCount: number;
         /**
-         * a number of required questions that have input(s). We do not count html or expression questions
+         * The number of answered questions.
          */
-        requiredQuestionCount: number;
+        answeredQuestionCount: number;
         /**
-         * a number of questions that have input(s) and an user has answered
+         * The number of questions marked as required.
          */
-        answeredQuestionCount: number;
+        requiredQuestionCount: number;
         /**
-         * a number of questions that have input(s). We do not count html or expression questions
+         * The number of answered questions marked as required.
          */
-        questionCount: number;
+        requiredAnsweredQuestionCount: number;
         /**
-         * a progress text, that SurveyJS will render in progress bar
+         * Progress text rendered in the [progress bar](#showProgressBar). You can change this parameter's value.
          */
         text: string;
     }
@@ -6838,7 +6889,7 @@ declare module "question_textbase" {
         updateRemainingCharacterCounter(newValue: string, maxLength: number): void;
     }
     /**
-     * A base class for the [Text](https://surveyjs.io/form-library/documentation/questiontextmodel) and [Comment](https://surveyjs.io/form-library/documentation/questioncommentmodel) question types.
+     * A base class for the [Single-Line Input](https://surveyjs.io/form-library/documentation/questiontextmodel) and [Long Text](https://surveyjs.io/form-library/documentation/questioncommentmodel) question types.
      */
     export class QuestionTextBase extends Question {
         constructor(name: string);
@@ -6883,7 +6934,7 @@ declare module "question_textbase" {
         localeChanged(): void;
         setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
         protected calcRenderedPlaceholder(): void;
-        protected hasPlaceHolder(): boolean;
+        protected hasPlaceholder(): boolean;
         protected setNewValue(newValue: any): void;
         protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
         disableNativeUndoRedo: boolean;
@@ -6909,7 +6960,7 @@ declare module "question_text" {
     import { SurveyError } from "survey-error";
     import { QuestionTextBase } from "question_textbase";
     /**
-     * A class that describes the Text question type.
+     * A class that describes the Single-Line Input question type.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/questiontype-text/ (linkStyle))
      */
@@ -6926,6 +6977,7 @@ declare module "question_text" {
          */
         get inputType(): string;
         set inputType(val: string);
+        getMaxLength(): any;
         runCondition(values: HashTable<any>, properties: HashTable<any>): void;
         isLayoutTypeSupported(layoutType: string): boolean;
         /**
@@ -7019,7 +7071,7 @@ declare module "question_text" {
         protected canRunValidators(isOnValueChanged: boolean): boolean;
         protected setNewValue(newValue: any): void;
         protected correctValueType(newValue: any): any;
-        protected hasPlaceHolder(): boolean;
+        protected hasPlaceholder(): boolean;
         isReadOnlyRenderDiv(): boolean;
         get inputStyle(): any;
         private _isWaitingForEnter;
@@ -7054,7 +7106,7 @@ declare module "question_multipletext" {
         get a11y_input_ariaLabelledBy(): string;
     }
     /**
-     * A class that describes an item in a [Multiple Text](https://surveyjs.io/form-library/documentation/api-reference/multiple-text-entry-question-model) question.
+     * A class that describes an item in a [Multiple Textboxes](https://surveyjs.io/form-library/documentation/api-reference/multiple-text-entry-question-model) question.
      *
      * [View Demo](/form-library/examples/multiple-text-box-question/)
      */
@@ -7078,6 +7130,7 @@ declare module "question_multipletext" {
         localeChanged(): void;
         locStrsChanged(): void;
         setData(data: IMultipleTextData): void;
+        focusIn(): void;
         /**
          * Set this property to true, to make the item a required. If a user doesn't fill the item then a validation error will be generated.
          */
@@ -7169,6 +7222,7 @@ declare module "question_multipletext" {
         setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
         get isAllowTitleLeft(): boolean;
         get hasSingleInput(): boolean;
+        get isContainer(): boolean;
         get id(): string;
         set id(val: string);
         onSurveyLoad(): void;
@@ -7207,6 +7261,19 @@ declare module "question_multipletext" {
         getConditionJson(operator?: string, path?: string): any;
         locStrsChanged(): void;
         localeChanged(): void;
+        /**
+         * Specifies the error message position relative to individual input fields.
+         *
+         * Possible values:
+         *
+         * - `"default"` (default) - Inherits the setting from the [`errorLocation`](#errorLocation) property.
+         * - `"top"` - Displays error messages above input fields.
+         * - `"bottom"` - Displays error messages below input fields.
+         */
+        get itemErrorLocation(): string;
+        set itemErrorLocation(val: string);
+        getQuestionErrorLocation(): string;
+        getChildErrorLocation(child: Question): string;
         protected isNewValueCorrect(val: any): boolean;
         supportGoNextPageAutomatic(): boolean;
         /**
@@ -7273,7 +7340,7 @@ declare module "themes" {
 declare module "survey" {
     import { JsonError } from "jsonobject";
     import { Base, EventBase } from "base";
-    import { ISurvey, ISurveyData, ISurveyImpl, ITextProcessor, IQuestion, IPanel, IElement, IPage, ISurveyErrorOwner, ISurveyElement, IProgressInfo, IFindElement, ISurveyLayoutElement, LayoutElementContainer } from "base-interfaces";
+    import { ISurvey, ISurveyData, ISurveyImpl, ITextProcessor, IQuestion, IPanel, IElement, IPage, ISurveyErrorOwner, ISurveyElement, IProgressInfo, IFindElement, ISurveyLayoutElement, IPlainDataOptions, LayoutElementContainer } from "base-interfaces";
     import { SurveyElementCore } from "survey-element";
     import { ISurveyTriggerOwner, SurveyTrigger, Trigger } from "trigger";
     import { CalculatedValue } from "calculatedValue";
@@ -7320,7 +7387,7 @@ declare module "survey" {
          *
          * Many question types allow respondents to leave comments. To enable this functionality, set a question's [`showCommentArea`](https://surveyjs.io/form-library/documentation/api-reference/checkbox-question-model#showCommentArea) property to `true`. Comment values are saved in a separate property. The property name is composed of the question `name` and `commentSuffix`.
          *
-         * Respondents can also leave a comment when they select "Other" in a single- or multi-select question, such as Dropdown or Checkboxes. The property name for the comment value is composed according to the same rules. However, you can use the question `name` as a key to store the comment value instead. Disable the [`storeOthersAsComment`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#storeOthersAsComment) property in this case.
+         * Respondents can also leave comments when they select "Other" in choice-based questions, such as Dropdown or Checkboxes. The property name for the comment value is composed according to the same rules. However, you can use the question `name` as a key to store the comment value instead. Disable the [`storeOthersAsComment`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#storeOthersAsComment) property in this case.
          *
          * [View Demo](https://surveyjs.io/form-library/examples/create-checkboxes-question-in-javascript/ (linkStyle))
          */
@@ -7609,7 +7676,8 @@ declare module "survey" {
          */
         onGetQuestionNo: EventBase<SurveyModel, GetQuestionNoEvent>;
         /**
-         * Use this event to change the progress text in code.
+         * An event that is raised before the survey displays progress text. Handle this event to change the progress text in code.
+         * @see showProgressBar
          * @see progressBarType
          */
         onProgressText: EventBase<SurveyModel, ProgressTextEvent>;
@@ -8201,38 +8269,36 @@ declare module "survey" {
         beforeSettingPanelErrors(question: IPanel, errors: Array<SurveyError>): void;
         private maakeRequiredErrorsInvisibgle;
         /**
-         * Gets or sets the first question index. The first question index is '1' by default. You may start it from '100' or from 'A', by setting '100' or 'A' to this property.
-         * You can set the start index to "(1)" or "# A)" or "a)" to render question number as (1), # A) and a) accordingly.
-         * @see Question.title
-         * @see requiredText
+         * Specifies the initial number or letter from which to start question numbering.
          *
-         * [View Demo](https://surveyjs.io/form-library/examples/survey-processtext/ (linkStyle))
+         * [Question Numbers](https://surveyjs.io/form-library/documentation/design-survey/configure-question-titles#question-numbers (linkStyle))
          */
         get questionStartIndex(): string;
         set questionStartIndex(val: string);
         /**
-         * Gets or sets whether the "Others" option text is stored as question comment.
+         * Specifies whether to store the "Other" option response in a separate property.
+         *
+         * Default value: `true`
          *
-         * By default the entered text in the "Others" input in the checkbox/radiogroup/dropdown is 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.
-         * @see commentSuffix
+         * Respondents can leave comments when they select "Other" in choice-based questions, such as Dropdown or Checkboxes. Comment values are saved in a separate property. The property name is composed of the question `name` and [`commentSuffix`](#commentSuffix). However, you can use the question `name` as a key to store the comment value instead. Disable the `storeOthersAsComment` property in this case.
+         * @see maxOthersLength
          */
         get storeOthersAsComment(): boolean;
         set storeOthersAsComment(val: boolean);
         /**
-         * Specifies the default maximum length for questions like text and comment, including matrix cell questions.
+         * Specifies the maximum text length in textual questions ([Single-Line Input](https://surveyjs.io/form-library/examples/text-entry-question/), [Long Text](https://surveyjs.io/form-library/examples/add-open-ended-question-to-a-form/), [Multiple Textboxes](https://surveyjs.io/form-library/examples/multiple-text-box-question/)), measured in characters.
+         *
+         * Default value: 0 (unlimited)
          *
-         * The default value is `0`, that means that the text and comment have the same max length as the standard HTML input - 524288 characters: https://www.w3schools.com/tags/att_input_maxlength.asp.
+         * You can override this setting for individual questions if you specify their [`maxLength`](https://surveyjs.io/form-library/documentation/api-reference/text-entry-question-model#maxLength) property.
          * @see maxOthersLength
          */
         get maxTextLength(): number;
         set maxTextLength(val: number);
         /**
-         * Gets or sets the default maximum length for question comments and others
+         * Specifies the maximum text length for question comments. Applies to questions with the [`showCommentArea`](https://surveyjs.io/form-library/documentation/api-reference/question#showCommentArea) or [`showOtherItem`](https://surveyjs.io/form-library/documentation/api-reference/question#showOtherItem) property set to `true`.
          *
-         * The default value is `0`, that means that the question comments have the same max length as the standard HTML input - 524288 characters: https://www.w3schools.com/tags/att_input_maxlength.asp.
-         * @see Question.showCommentArea
-         * @see Question.showOtherItem
+         * Default value: 0 (unlimited)
          * @see maxTextLength
          */
         get maxOthersLength(): number;
@@ -8244,7 +8310,7 @@ declare module "survey" {
          *
          * If you enable this property, the survey is also completed automatically. Set the [`allowCompleteSurveyAutomatic`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#allowCompleteSurveyAutomatic) property to `false` if you want to disable this behavior.
          *
-         * > If any of the following questions is answered last, the survey does not switch to the next page: Checkbox, Boolean (rendered as Checkbox), Comment, Signature Pad, Image Picker (with Multi Select), File, Single-Choice Matrix (not all rows are answered), Dynamic Matrix, Panel Dynamic.
+         * > If any of the following questions is answered last, the survey does not switch to the next page: Checkboxes, Yes/No (Boolean) (rendered as Checkbox), Long Text, Signature, Image Picker (with Multi Select), File Upload, Single-Select Matrix (not all rows are answered), Dynamic Matrix, Dynamic Panel.
          *
          * [View Demo](https://surveyjs.io/form-library/examples/automatically-move-to-next-page-if-answer-selected/ (linkStyle))
          */
@@ -8475,9 +8541,7 @@ declare module "survey" {
          * An image to display in the background of the survey or form. Accepts a base64 or URL string value.
          * @see backgroundOpacity
          */
-        get backgroundImage(): string;
-        set backgroundImage(value: string);
-        get locBackgroundImage(): LocalizableString;
+        backgroundImage: string;
         renderBackgroundImage: string;
         private updateRenderBackgroundImage;
         backgroundImageFit: ImageFit;
@@ -8621,9 +8685,9 @@ declare module "survey" {
         getUpdatedQuestionTitle(question: Question, title: string): string;
         getUpdatedQuestionNo(question: Question, no: string): string;
         /**
-         * Gets or sets whether the survey displays page numbers on pages titles.
+         * Specifies whether page titles contain page numbers.
          *
-         * [View Demo](https://surveyjs.io/form-library/examples/survey-options/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/how-to-number-pages-and-questions/ (linkStyle))
          */
         get showPageNumbers(): boolean;
         set showPageNumbers(value: boolean);
@@ -8688,22 +8752,27 @@ declare module "survey" {
         set questionTitleLocation(value: string);
         updateElementCss(reNew?: boolean): void;
         /**
-         * Gets or sets the error message position.
+         * Specifies the error message position.
          *
-         * The following options are available:
+         * Possible values:
+         *
+         * - `"top"` (default) - Displays error messages above questions.
+         * - `"bottom"` - Displays error messages below questions.
          *
-         * - `top` - to show question error(s) over the question,
-         * - `bottom` - to show question error(s) under the question.
+         * You can override this setting if you specify the `questionErrorLocation` property for an [individual page](https://surveyjs.io/form-library/documentation/pagemodel#questionErrorLocation) or [panel](https://surveyjs.io/form-library/documentation/panelmodel#questionErrorLocation) or set the `errorLocation` property for a [specific question](https://surveyjs.io/form-library/documentation/question#errorLocation).
          */
         get questionErrorLocation(): string;
         set questionErrorLocation(value: string);
         /**
-         * Gets or sets the question description position. The default value is `underTitle`.
+         * Specifies where to display question descriptions.
          *
-         * The following options are available:
+         * Possible values:
+         *
+         * - `"underTitle"` (default) - Displays descriptions under question titles.
+         * - `"underInput"` - Displays descriptions under the interactive area.
+         *
+         * You can override this setting for individual questions if you specify their [`descriptionLocation`](https://surveyjs.io/form-library/documentation/api-reference/question#descriptionLocation) property.
          *
-         * - `underTitle` - show question description under the question title,
-         * - `underInput` - show question description under the question input instead of question title.
          */
         get questionDescriptionLocation(): string;
         set questionDescriptionLocation(value: string);
@@ -8765,14 +8834,7 @@ declare module "survey" {
          *
          * If you want to skip empty answers, pass an object with the `includeEmpty` property set to `false`.
          */
-        getPlainData(options?: {
-            includeEmpty?: boolean;
-            includeQuestionTypes?: boolean;
-            includeValues?: boolean;
-            calculations?: Array<{
-                propertyName: string;
-            }>;
-        }): Array<IQuestionPlainData>;
+        getPlainData(options?: IPlainDataOptions): Array<IQuestionPlainData>;
         getFilteredValues(): any;
         private addCalculatedValuesIntoFilteredValues;
         getFilteredProperties(): any;
@@ -9227,6 +9289,7 @@ declare module "survey" {
          * The `doComplete()` method completes the survey regardless of validation errors and the current page. If you need to ensure that survey results are valid and full, call the [`completeLastPage()`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#completeLastPage) method instead.
          *
          * @param isCompleteOnTrigger For internal use.
+         * @param completeTrigger For internal use.
          * @returns `false` if survey completion is cancelled within the [`onCompleting`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onCompleting) event handler; otherwise, `true`.
          * @see surveyPostId
          */
@@ -9343,7 +9406,7 @@ declare module "survey" {
         private getUpdatedPanelTitleActions;
         private getUpdatedPageTitleActions;
         getUpdatedMatrixRowActions(question: QuestionMatrixDropdownModelBase, row: any, actions: Array<IAction>): IAction[];
-        scrollElementToTop(element: ISurveyElement, question: Question, page: PageModel, id: string): any;
+        scrollElementToTop(element: ISurveyElement, question: Question, page: PageModel, id: string, scrollIfVisible?: boolean): any;
         /**
          * Uploads a file to server.
          *
@@ -9537,6 +9600,7 @@ declare module "survey" {
         private triggerValues;
         private triggerKeys;
         private checkTriggers;
+        private get hasRequiredValidQuestionTrigger();
         private doElementsOnLoad;
         private conditionValues;
         private get isRunningConditions();
@@ -10002,7 +10066,7 @@ declare module "survey-element" {
         dragTypeOverMe: DragTypeOverMeEnum;
         isDragMe: boolean;
         readOnlyChangedCallback: () => void;
-        static ScrollElementToTop(elementId: string): boolean;
+        static ScrollElementToTop(elementId: string, scrollIfVisible?: boolean): boolean;
         static GetFirstNonTextElement(elements: any, removeSpaces?: boolean): any;
         static FocusElement(elementId: string): boolean;
         private static focusElementCore;
@@ -10208,7 +10272,7 @@ declare module "survey-element" {
          * @see Base.getType
          */
         get isQuestion(): boolean;
-        delete(): void;
+        delete(doDispose: boolean): void;
         locOwner: ILocalizableOwner;
         /**
          * Returns the survey's [locale](https://surveyjs.io/form-library/documentation/surveymodel#locale).
@@ -10376,7 +10440,7 @@ declare module "console-warnings" {
 declare module "question" {
     import { HashTable } from "helpers";
     import { EventBase } from "base";
-    import { IElement, IQuestion, IPanel, IConditionRunner, ISurveyImpl, IPage, ITitleOwner, IProgressInfo, ISurvey } from "base-interfaces";
+    import { IElement, IQuestion, IPanel, IConditionRunner, ISurveyImpl, IPage, ITitleOwner, IProgressInfo, ISurvey, IPlainDataOptions } from "base-interfaces";
     import { SurveyElement } from "survey-element";
     import { SurveyValidator, IValidatorOwner } from "validator";
     import { TextPreProcessorValue } from "textPreProcessor";
@@ -10480,7 +10544,7 @@ declare module "question" {
         get page(): IPage;
         set page(val: IPage);
         getPanel(): IPanel;
-        delete(): void;
+        delete(doDispose?: boolean): void;
         protected removeFromParent(): void;
         protected addDependedQuestion(question: Question): void;
         protected removeDependedQuestion(question: Question): void;
@@ -10638,7 +10702,19 @@ declare module "question" {
         get hasTitleOnTop(): boolean;
         get hasTitleOnBottom(): boolean;
         get hasTitleOnLeftTop(): boolean;
+        /**
+         * Specifies the error message position. Overrides the `questionErrorLocation` property specified for the question's container ([survey](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#questionErrorLocation), [page](https://surveyjs.io/form-library/documentation/api-reference/page-model#questionErrorLocation), or [panel](https://surveyjs.io/form-library/documentation/api-reference/panel-model#questionErrorLocation)).
+         *
+         * Possible values:
+         *
+         * - `"default"` (default) - Inherits the setting from the `questionErrorLocation` property specified for the question's container.
+         * - `"top"` - Displays error messages above questions.
+         * - `"bottom"` - Displays error messages below questions.
+         */
         get errorLocation(): string;
+        set errorLocation(val: string);
+        getErrorLocation(): string;
+        getChildErrorLocation(child: Question): string;
         /**
          * 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).
          * @see hasSingleInput
@@ -10694,12 +10770,15 @@ declare module "question" {
         commentPlaceholder: string;
         get commentPlaceHolder(): string;
         set commentPlaceHolder(newValue: string);
+        get renderedCommentPlaceholder(): string;
+        private calcRenderedCommentPlaceholder;
         getAllErrors(): Array<SurveyError>;
         getErrorByType(errorType: string): SurveyError;
         get customWidget(): QuestionCustomWidget;
         updateCustomWidget(): void;
         localeChanged(): void;
         get isCompositeQuestion(): boolean;
+        get isContainer(): boolean;
         protected updateCommentElements(): void;
         onCommentInput(event: any): void;
         onCommentChange(event: any): void;
@@ -10761,7 +10840,7 @@ declare module "question" {
          * Moves focus to the input field of this question.
          * @param onError Pass `true` if you want to focus an input field with the first validation error. Default value: `false` (focuses the first input field). Applies to question types with multiple input fields.
          */
-        focus(onError?: boolean): void;
+        focus(onError?: boolean, scrollIfVisible?: boolean): void;
         private focuscore;
         private expandAllParents;
         focusIn(): void;
@@ -10867,8 +10946,32 @@ declare module "question" {
         get isValueArray(): boolean;
         /**
          * Gets or sets the question value.
-         * @see SurveyModel.setValue
-         * @see SurveyModel.getValue
+         *
+         * The following table illustrates how the value type depends on the question type:
+         *
+         * | Question type | Value type(s) |
+         * | ------------- | ------------- |
+         * | Checkboxes | `Array<String \| Number>` |
+         * | Dropdown | `String` \| `Number` |
+         * | Dynamic Matrix | `Array<Object>` |
+         * | Dynamic Panel | `Array<Object>` |
+         * | Expression | `String` \| `Number` \| `Boolean` |
+         * | File Upload | `File` \| `Array<File>` |
+         * | HTML | (no value) |
+         * | Image | (no value) |
+         * | Image Picker | `Array<String \| Number>` |
+         * | Long Text | `String` |
+         * | Multi-Select Dropdown | `Object` |
+         * | Multi-Select Matrix | `Object` |
+         * | Multiple Textboxes | `Array<String>` |
+         * | Panel | (no value) |
+         * | Radio Button Group | `String` \| `Number` |
+         * | Ranking | `Array<String \| Number>` |
+         * | Rating Scale | `Number` \| `String` |
+         * | Signature | `String` (base64-encoded image) |
+         * | Single-Line Input | `String` \| `Number` \| `Date` |
+         * | Single-Select Matrix | `Object` |
+         * | Yes/No (Boolean) | `Boolean` \| `String` |
          */
         get value(): any;
         set value(newValue: any);
@@ -10954,13 +11057,8 @@ declare module "question" {
          *
          * Pass an object with the `includeEmpty` property set to `false` if you want to skip empty answers.
          */
-        getPlainData(options?: {
-            includeEmpty?: boolean;
-            includeQuestionTypes?: boolean;
-            calculations?: Array<{
-                propertyName: string;
-            }>;
-        }): IQuestionPlainData;
+        getPlainData(options?: IPlainDataOptions): IQuestionPlainData;
+        protected getPlainDataCalculatedValue(propName: string): any;
         /**
          * 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).
          * @see SurveyModel.getCorrectAnswerCount
@@ -11072,6 +11170,7 @@ declare module "question" {
         private isOldAnswered;
         protected allowNotifyValueChanged: boolean;
         protected setNewValue(newValue: any): void;
+        private checkIsValueCorrect;
         protected isNewValueCorrect(val: any): boolean;
         protected isNewValueEqualsToValue(newValue: any): boolean;
         protected isTextValue(): boolean;
@@ -11129,6 +11228,7 @@ declare module "question" {
         set validatedValue(val: any);
         getAllValues(): any;
         processPopupVisiblilityChanged(popupModel: PopupModel, visible: boolean): void;
+        protected onTextKeyDownHandler(event: any): void;
         transformToMobileView(): void;
         transformToDesktopView(): void;
         needResponsiveWidth(): boolean;
@@ -11147,6 +11247,7 @@ declare module "question" {
         protected processResponsiveness(requiredWidth: number, availableWidth: number): any;
         destroyResizeObserver(): void;
         dispose(): void;
+        private resetDependedQuestions;
     }
 }
 declare module "martixBase" {
@@ -11265,10 +11366,10 @@ declare module "martixBase" {
 }
 declare module "question_matrixdropdownbase" {
     import { QuestionMatrixBaseModel } from "martixBase";
-    import { Question, IConditionObject } from "question";
+    import { Question, IConditionObject, IQuestionPlainData } from "question";
     import { HashTable } from "helpers";
     import { Base } from "base";
-    import { IElement, IQuestion, ISurveyData, ISurvey, ISurveyImpl, ITextProcessor, IProgressInfo, IPanel } from "base-interfaces";
+    import { IElement, IQuestion, ISurveyData, ISurvey, ISurveyImpl, ITextProcessor, IProgressInfo, IPanel, IPlainDataOptions } from "base-interfaces";
     import { ItemValue } from "itemvalue";
     import { ILocalizableOwner, LocalizableString } from "localizablestring";
     import { PanelModel } from "panel";
@@ -11443,6 +11544,7 @@ declare module "question_matrixdropdownbase" {
         getType(): string;
         dispose(): void;
         get hasSingleInput(): boolean;
+        get isContainer(): boolean;
         get isRowsDynamic(): boolean;
         private isUpdating;
         protected get isUpdateLocked(): boolean;
@@ -11462,6 +11564,31 @@ declare module "question_matrixdropdownbase" {
         set columnLayout(val: string);
         get columnsLocation(): string;
         set columnsLocation(val: string);
+        /**
+         * Specifies the error message position for questions within detail sections.
+         *
+         * Possible values:
+         *
+         * - `"default"` (default) - Inherits the setting from the [`errorLocation`](#errorLocation) property.
+         * - `"top"` - Displays error messages above questions.
+         * - `"bottom"` - Displays error messages below questions.
+         * @see cellErrorLocation
+         */
+        get detailErrorLocation(): string;
+        set detailErrorLocation(value: string);
+        /**
+         * Specifies the error message position relative to matrix cells.
+         *
+         * Possible values:
+         *
+         * - `"default"` (default) - Inherits the setting from the [`errorLocation`](#errorLocation) property.
+         * - `"top"` - Displays error messages above matrix cells.
+         * - `"bottom"` - Displays error messages below matrix cells.
+         * @see detailErrorLocation
+         */
+        get cellErrorLocation(): string;
+        set cellErrorLocation(value: string);
+        getChildErrorLocation(child: Question): string;
         /**
          * Returns `true` if columns are placed in the horizontal direction and rows in the vertical direction.
          *
@@ -11590,6 +11717,7 @@ declare module "question_matrixdropdownbase" {
         private checkColumnsVisibility;
         private checkColumnsRenderedRequired;
         private isColumnVisibilityChanged;
+        private updateNewVisibleChoices;
         protected runTotalsCondition(values: HashTable<any>, properties: HashTable<any>): void;
         private getRowConditionValues;
         IsMultiplyColumn(column: MatrixDropdownColumn): boolean;
@@ -11669,12 +11797,7 @@ declare module "question_matrixdropdownbase" {
         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?: {
-            includeEmpty?: boolean;
-            calculations?: Array<{
-                propertyName: string;
-            }>;
-        }): import("question").IQuestionPlainData;
+        getPlainData(options?: IPlainDataOptions): IQuestionPlainData;
         addConditionObjectsByContext(objects: Array<IConditionObject>, context: any): void;
         protected collectNestedQuestionsCore(questions: Question[], visibleOnly: boolean): void;
         protected getConditionObjectRowName(index: number): string;
@@ -11894,7 +12017,7 @@ declare module "base-interfaces" {
         dynamicPanelRemoving(question: IQuestion, panelIndex: number, panel: IPanel): boolean;
         dynamicPanelItemValueChanged(question: IQuestion, options: any): any;
         dragAndDropAllow(options: DragDropAllowEvent): boolean;
-        scrollElementToTop(element: ISurveyElement, question: IQuestion, page: IPage, id: string): any;
+        scrollElementToTop(element: ISurveyElement, question: IQuestion, page: IPage, id: string, scrollIfVisible?: boolean): any;
         runExpression(expression: string): any;
         elementContentVisibilityChanged(element: ISurveyElement): void;
         onCorrectQuestionAnswer(question: IQuestion, options: any): void;
@@ -11926,7 +12049,7 @@ declare module "base-interfaces" {
         getType(): string;
         setVisibleIndex(value: number): number;
         locStrsChanged(): any;
-        delete(): any;
+        delete(doDispose?: boolean): void;
         toggleState(): void;
         stateChangedCallback(): void;
         getTitleToolbar(): AdaptiveActionContainer;
@@ -11986,6 +12109,7 @@ declare module "base-interfaces" {
         getChildrenLayoutType(): string;
         getQuestionTitleLocation(): string;
         getQuestionStartIndex(): string;
+        getQuestionErrorLocation(): string;
         parent: IPanel;
         elementWidthChanged(el: IElement): any;
         indexOf(el: IElement): number;
@@ -12034,6 +12158,14 @@ declare module "base-interfaces" {
         template?: string;
         data?: any;
     }
+    export interface IPlainDataOptions {
+        includeEmpty?: boolean;
+        includeQuestionTypes?: boolean;
+        includeValues?: boolean;
+        calculations?: Array<{
+            propertyName: string;
+        }>;
+    }
 }
 declare module "itemvalue" {
     import { ILocalizableOwner, LocalizableString } from "localizablestring";
@@ -12330,7 +12462,9 @@ declare module "base" {
          * @param defaultValue (Optional) A value to return if the property is not found or does not have a value.
          */
         getPropertyValue(name: string, defaultValue?: any): any;
-        private getDefaultValueFromProperty;
+        getDefaultPropertyValue(name: string): any;
+        hasDefaultPropertyValue(name: string): boolean;
+        resetPropertyValue(name: string): void;
         protected getPropertyValueWithoutDefault(name: string): any;
         protected getPropertyValueCore(propertiesHash: any, name: string): any;
         geValueFromHash(): any;
@@ -12927,10 +13061,20 @@ declare module "settings" {
          */
         tagboxCloseOnSelect: boolean;
         /**
-         * A property that allows you to display a custom confirm dialog instead of the standard browser dialog. Set this property to a function that renders your custom dialog window.
+         * A property that allows you to display a custom confirm dialog instead of the standard browser dialog.
+         *
+         * Set this property to a function that renders your custom dialog window. This function should return `true` if a user confirms an action or `false` otherwise.
          * @param message A message to be displayed in the confirm dialog window.
          */
         confirmActionFunc: (message: string) => boolean;
+        /**
+         * A property that allows you to display a custom confirm dialog instead of the standard browser dialog in async mode.
+         *
+         * Set this property to a function that renders your custom dialog window. This function should return `true` to be enabled; otherwise, a survey executes the [`confirmActionFunc`](#confirmActionFunc) function. Pass the dialog result as the `callback` parameter: `true` if a user confirms an action, `false` otherwise.
+         * @param message A message to be displayed in the confirm dialog window.
+         * @param callback A callback function that should be called with `true` if a user confirms an action or `false` otherwise.
+         */
+        confirmActionAsync: (message: string, callback: (res: boolean) => void) => boolean;
         /**
          * A minimum width value for all survey elements.
          *
@@ -13064,7 +13208,7 @@ declare module "question_matrixdropdown" {
         get locText(): LocalizableString;
     }
     /**
-      * 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.
+      * A class that describes the Multi-Select Matrix question type. Multi-Select 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))
      */
@@ -13140,6 +13284,7 @@ declare module "dropdownListModel" {
         clear(): void;
         protected onSetFilterString(): void;
         get isAllDataLoaded(): boolean;
+        get canShowSelectedItem(): boolean;
         searchEnabled: boolean;
         filterString: string;
         inputString: string;
@@ -13321,7 +13466,8 @@ declare module "question_matrix" {
     import { Base } from "base";
     import { SurveyError } from "survey-error";
     import { LocalizableString, ILocalizableOwner } from "localizablestring";
-    import { IConditionObject } from "question";
+    import { IConditionObject, IQuestionPlainData } from "question";
+    import { IPlainDataOptions } from "base-interfaces";
     export interface IMatrixData {
         onMatrixRowChanged(row: MatrixRowModel): void;
         getCorrectedRowValue(value: any): any;
@@ -13367,7 +13513,7 @@ declare module "question_matrix" {
         protected createString(): LocalizableString;
     }
     /**
-      * A class that describes the Single-Choice Matrix question type.
+      * A class that describes the Single-Select Matrix question type.
       *
       * [View Demo](https://surveyjs.io/form-library/examples/single-selection-matrix-table-question/ (linkStyle))
       */
@@ -13435,12 +13581,7 @@ declare module "question_matrix" {
         protected onMatrixRowCreated(row: MatrixRowModel): void;
         protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
         protected getDisplayValueCore(keysAsText: boolean, value: any): any;
-        getPlainData(options?: {
-            includeEmpty?: boolean;
-            calculations?: Array<{
-                propertyName: string;
-            }>;
-        }): import("question").IQuestionPlainData;
+        getPlainData(options?: IPlainDataOptions): IQuestionPlainData;
         addConditionObjectsByContext(objects: Array<IConditionObject>, context: any): void;
         getConditionJson(operator?: string, path?: string): any;
         protected clearValueIfInvisibleCore(reason: string): void;
@@ -13547,7 +13688,7 @@ declare module "question_checkbox" {
     import { IQuestion } from "base-interfaces";
     import { SurveyError } from "survey-error";
     /**
-     * A class that describes the Checkbox question type.
+     * A class that describes the Checkboxes question type.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/questiontype-checkbox/ (linkStyle))
      */
@@ -13741,7 +13882,7 @@ declare module "question_tagbox" {
     import { EventBase } from "base";
     import { ItemValue } from "itemvalue";
     /**
-     * A Model for a tagbox question
+     * A class that describes the Multi-Select Dropdown (Tag Box) question type.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/how-to-create-multiselect-tag-box/ (linkStyle))
      */
@@ -14107,7 +14248,7 @@ declare module "question_ranking" {
 declare module "question_comment" {
     import { QuestionTextBase } from "question_textbase";
     /**
-     * A class that describes the Comment question type.
+     * A class that describes the Long Text question type.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/questiontype-comment/ (linkStyle))
      */
@@ -14161,7 +14302,7 @@ declare module "question_html" {
     import { QuestionNonValue } from "questionnonvalue";
     import { LocalizableString } from "localizablestring";
     /**
-      * A class that describes the Html question type. Unlike other question types, Html cannot have a title or value.
+      * A class that describes the HTML question type. Unlike other question types, HTML cannot have a title or value.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/questiontype-html/ (linkStyle))
      */
@@ -14188,7 +14329,7 @@ declare module "question_radiogroup" {
     import { ItemValue } from "itemvalue";
     import { Action } from "actions/action";
     /**
-     * A class that describes the Radiogroup question type.
+     * A class that describes the Radio Button Group question type.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/questiontype-radiogroup/ (linkStyle))
      */
@@ -14345,6 +14486,7 @@ declare module "question_rating" {
         getInputId(index: number): string;
         supportGoNextPageAutomatic(): boolean;
         supportOther(): boolean;
+        protected getPlainDataCalculatedValue(propName: string): any;
         /**
          * Specifies a description for the minimum (first) rate value.
          * @see rateValues
@@ -14485,7 +14627,7 @@ declare module "question_boolean" {
     import { LocalizableString } from "localizablestring";
     import { ActionContainer } from "actions/container";
     /**
-     * A class that describes the Boolean question type.
+     * A class that describes the Yes/No (Boolean) question type.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/questiontype-boolean/ (linkStyle))
      */
@@ -14670,7 +14812,7 @@ declare module "question_signaturepad" {
     import { Question } from "question";
     import { ISurveyImpl } from "base-interfaces";
     /**
-     * A class that describes the Signature Page question type.
+     * A class that describes the Signature question type.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/signature-pad-widget-javascript/ (linkStyle))
      */
@@ -14719,17 +14861,35 @@ declare module "question_signaturepad" {
         set allowClear(val: boolean);
         get canShowClearButton(): boolean;
         /**
-         * Specifies a color for the pen. Accepts hexadecimal colors (`"#FF0000"`), RGB colors (`"rgb(255,0,0)"`), or color names (`"red"`).
+         * Specifies a color for the pen.
+         *
+         * This property accepts color values in the following formats:
+         *
+         * - Hexadecimal colors (`"#FF0000"`)
+         * - RGB colors (`"rgb(255,0,0)"`)
+         * - Color names (`"red"`)
          * @see backgroundColor
          */
         get penColor(): string;
         set penColor(val: string);
         /**
-         * Specifies a color for the signature area background.  Accepts hexadecimal colors (`"#FF0000"`), RGB colors (`"rgb(255,0,0)"`), or color names (`"red"`).
+         * Specifies a color for the signature area background. Ignored if [`backgroundImage`](#backgroundImage) is set.
+         *
+         * This property accepts color values in the following formats:
+         *
+         * - Hexadecimal colors (`"#FF0000"`)
+         * - RGB colors (`"rgb(255,0,0)"`)
+         * - Color names (`"red"`)
          * @see penColor
          */
         get backgroundColor(): string;
         set backgroundColor(val: string);
+        /**
+         * An image to display in the background of the signature area. Accepts a base64 or URL string value.
+         * @see backgroundColor
+         */
+        get backgroundImage(): string;
+        set backgroundImage(val: string);
         get clearButtonCaption(): string;
         needShowPlaceholder(): boolean;
         get placeHolderText(): string;
@@ -14908,7 +15068,9 @@ declare module "question_custom" {
          */
         title?: string;
         /**
-         * An icon name for the custom question type.
+         * The name of an icon to use for the custom question type.
+         *
+         * [UI Icons](https://surveyjs.io/form-library/documentation/icons (linkStyle))
          */
         iconName?: string;
         /**
@@ -15151,6 +15313,7 @@ declare module "question_custom" {
         indexOf(el: IElement): number;
         ensureRowsVisibility(): void;
         validateContainerOnly(): void;
+        getQuestionErrorLocation(): string;
         protected getContentDisplayValueCore(keyAsText: boolean, value: any, question: Question): any;
     }
     export class QuestionCustomModel extends QuestionCustomModelBase {
@@ -15198,6 +15361,8 @@ declare module "question_custom" {
         findQuestionByName(name: string): IQuestion;
         protected clearValueIfInvisibleCore(reason: string): void;
         onAnyValueChanged(name: string): void;
+        get hasSingleInput(): boolean;
+        get isContainer(): boolean;
         protected createPanel(): PanelModel;
         protected onReadOnlyChanged(): void;
         onSurveyLoad(): void;
@@ -15405,7 +15570,7 @@ declare module "entries/chunks/model" {
     export { AnswerCountValidator, EmailValidator, NumericValidator, RegexValidator, SurveyValidator, TextValidator, ValidatorResult, ExpressionValidator, ValidatorRunner } from "validator";
     export { ItemValue } from "itemvalue";
     export { Base, Event, EventBase, ArrayChanges, ComputedUpdater } from "base";
-    export { ISurvey, ISurveyElement, IElement, IQuestion, IPage, IPanel, ISurveyData, ITitleOwner, ISurveyLayoutElement, IShortcutText } from "base-interfaces";
+    export { ISurvey, ISurveyElement, IElement, IQuestion, IPage, IPanel, ISurveyData, ITitleOwner, ISurveyLayoutElement, IPlainDataOptions as IPlainData, IShortcutText } from "base-interfaces";
     export { SurveyError } from "survey-error";
     export { SurveyElementCore, SurveyElement, DragTypeOverMeEnum } from "survey-element";
     export { CalculatedValue } from "calculatedValue";
@@ -15462,7 +15627,7 @@ declare module "entries/chunks/model" {
     export * from "themes";
     export { SurveyModel } from "survey";
     export * from "survey-events-api";
-    export { SurveyTrigger, SurveyTriggerComplete, SurveyTriggerSetValue, SurveyTriggerVisible, SurveyTriggerCopyValue, SurveyTriggerRunExpression, Trigger } from "trigger";
+    export { SurveyTrigger, SurveyTriggerComplete, SurveyTriggerSetValue, SurveyTriggerVisible, SurveyTriggerCopyValue, SurveyTriggerRunExpression, SurveyTriggerSkip, Trigger } from "trigger";
     export { PopupSurveyModel, SurveyWindowModel } from "popup-survey";
     export { TextPreProcessor } from "textPreProcessor";
     export { Notifier } from "notifier";
@@ -15483,7 +15648,7 @@ declare module "entries/chunks/model" {
     export { DropdownMultiSelectListModel } from "dropdownMultiSelectListModel";
     export { QuestionButtonGroupModel, ButtonGroupItemModel, ButtonGroupItemValue } from "question_buttongroup";
     export { IsMobile, IsTouch, _setIsTouch } from "utils/devices";
-    export { confirmAction, detectIEOrEdge, doKey2ClickUp, doKey2ClickDown, doKey2ClickBlur, loadFileFromBase64, increaseHeightByContent, createSvg, sanitizeEditableContent, IAttachKey2clickOptions } from "utils/utils";
+    export { confirmAction, confirmActionAsync, detectIEOrEdge, doKey2ClickUp, doKey2ClickDown, doKey2ClickBlur, loadFileFromBase64, increaseHeightByContent, createSvg, sanitizeEditableContent, IAttachKey2clickOptions } from "utils/utils";
     export * from "utils/cssClassBuilder";
     export { surveyCss, defaultV2Css, defaultV2ThemeName } from "defaultCss/defaultV2Css";
     export { DragDropCore } from "dragdrop/core";
@@ -15837,6 +16002,8 @@ declare module "defaultCss/cssstandard" {
             root: string;
             controls: string;
             placeholder: string;
+            canvas: string;
+            backgroundImage: string;
             clearButton: string;
         };
         saveData: {
@@ -16299,6 +16466,8 @@ declare module "defaultCss/cssmodern" {
             small: string;
             controls: string;
             placeholder: string;
+            canvas: string;
+            backgroundImage: string;
             clearButton: string;
         };
         saveData: {
@@ -16705,6 +16874,8 @@ declare module "plugins/themes/bootstrap/cssbootstrap" {
             root: string;
             controls: string;
             placeholder: string;
+            canvas: string;
+            backgroundImage: string;
             clearButton: string;
         };
         saveData: {
@@ -17066,6 +17237,8 @@ declare module "plugins/themes/bootstrapmaterial/cssbootstrapmaterial" {
             root: string;
             controls: string;
             placeholder: string;
+            canvas: string;
+            backgroundImage: string;
             clearButton: string;
         };
         saveData: {
@@ -17533,6 +17706,8 @@ declare module "entries/plugins" {
             root: string;
             controls: string;
             placeholder: string;
+            canvas: string;
+            backgroundImage: string;
             clearButton: string;
         };
         saveData: {
@@ -17892,6 +18067,8 @@ declare module "entries/plugins" {
             root: string;
             controls: string;
             placeholder: string;
+            canvas: string;
+            backgroundImage: string;
             clearButton: string;
         };
         saveData: {
@@ -23631,6 +23808,7 @@ declare module "react/signaturepad" {
         constructor(props: any);
         protected get question(): QuestionSignaturePadModel;
         protected renderElement(): JSX.Element;
+        renderBackgroundImage(): JSX.Element | null;
         renderCleanButton(): JSX.Element | null;
     }
 }