survey-core 1.9.133 → 1.9.135

package/typings/mask/mask_numeric.d.ts

@@ -0,0 +1,88 @@
+import { InputMaskBase } from "./mask_base";
+import { IMaskedInputResult, ITextInputParams } from "./mask_utils";
+interface INumericalComposition {
+    integralPart: string;
+    fractionalPart: string;
+    isNegative?: boolean;
+    hasDecimalSeparator?: boolean;
+}
+export declare function splitString(str: string, reverse?: boolean, n?: number): Array<string>;
+/**
+ * A class that describes an input mask of the `"numeric"` [`maskType`](https://surveyjs.io/form-library/documentation/api-reference/text-entry-question-model#maskType).
+ *
+ * The following code shows how to specify the properties of this class within a survey JSON schema:
+ *
+ * ```js
+ * const surveyJson = {
+ *   "elements": [{
+ *     "name": "textquestion1"
+ *     "type": "text",
+ *     "maskType": "numeric",
+ *     "maskSettings": {
+ *       // Specify the properties of a numeric input mask here
+ *     }
+ *   }]
+ * }
+ * ```
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/masked-input-fields/ (linkStyle))
+ */
+export declare class InputMaskNumeric extends InputMaskBase {
+    /**
+     * Specifies whether respondents can enter negative values.
+     *
+     * Default value: `true`
+     * @see min
+     * @see max
+     */
+    allowNegativeValues: boolean;
+    /**
+     * A symbol used to separate the fractional part from the integer part of a displayed number.
+     *
+     * Default value: `"."`
+     * @see precision
+     * @see thousandsSeparator
+     */
+    decimalSeparator: string;
+    /**
+     * Limits how many digits to retain after the decimal point for a displayed number.
+     *
+     * Default value: 2
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/masked-input-fields/ (linkStyle))
+     * @see decimalSeparator
+     */
+    precision: number;
+    /**
+     * A symbol used to separate the digits of a large number into groups of three.
+     *
+     * Default value: `","`
+     * @see decimalSeparator
+     */
+    thousandsSeparator: string;
+    /**
+     * A minimum value that respondents can enter.
+     * @see max
+     * @see allowNegativeValues
+     */
+    min: number;
+    /**
+     * A maximum value that respondents can enter.
+     * @see min
+     * @see allowNegativeValues
+     */
+    max: number;
+    private calccaretPosition;
+    displayNumber(parsedNumber: INumericalComposition, insertThousandsSeparator?: boolean, matchWholeMask?: boolean): string;
+    convertNumber(parsedNumber: INumericalComposition): number;
+    validateNumber(number: INumericalComposition): boolean;
+    parseNumber(src: string | number): INumericalComposition;
+    getNumberMaskedValue(src: string | number, matchWholeMask?: boolean): string;
+    private getNumberUnmaskedValue;
+    getMaskedValue(src: any): string;
+    getUnmaskedValue(src: string): any;
+    processInput(args: ITextInputParams): IMaskedInputResult;
+    getType(): string;
+    protected isPropertyEmpty(value: any): boolean;
+}
+export {};

package/typings/mask/mask_pattern.d.ts

@@ -0,0 +1,70 @@
+import { InputMaskBase } from "./mask_base";
+import { IMaskedInputResult, ITextInputParams } from "./mask_utils";
+import { ILoadFromJSONOptions } from "../base-interfaces";
+export interface IMaskLiteral {
+    type: "const" | "regex" | "fixed";
+    value: any;
+}
+export declare function getLiterals(pattern: string): Array<IMaskLiteral>;
+export declare function getMaskedValueByPattern(src: string, pattern: string | Array<IMaskLiteral>, matchWholeMask: boolean): string;
+export declare function getUnmaskedValueByPattern(str: string, pattern: string | Array<IMaskLiteral>, matchWholeMask: boolean, skipFixedChar?: boolean): string;
+/**
+ * A class that describes an input mask of the `"pattern"` [`maskType`](https://surveyjs.io/form-library/documentation/api-reference/text-entry-question-model#maskType).
+ *
+ * The following code shows how to specify the properties of this class within a survey JSON schema:
+ *
+ * ```js
+ * const surveyJson = {
+ *   "elements": [{
+ *     "name": "textquestion1"
+ *     "type": "text",
+ *     "maskType": "pattern",
+ *     "maskSettings": {
+ *       // Specify the properties of a pattern input mask here
+ *     }
+ *   }]
+ * }
+ * ```
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/masked-input-fields/ (linkStyle))
+ */
+export declare class InputMaskPattern extends InputMaskBase {
+    private literals;
+    /**
+     * A pattern for the input value.
+     *
+     * If you set the [`maskType`](https://surveyjs.io/form-library/documentation/api-reference/text-entry-question-model#maskType) to `"pattern"`, the mask can contain string literals and the following placeholders:
+     *
+     * - `9` - A digit.
+     * - `a` - An upper- or lower-case letter.
+     * - `#` - A digit or an upper- or lower-case letter.
+     *
+     * Use backslash `\` to escape a character.
+     *
+     * Example: `+1(999)-999-99-99`
+     *
+     * If you set the [`maskType`](https://surveyjs.io/form-library/documentation/api-reference/text-entry-question-model#maskType) to `"datetime"`, the mask can contain separator characters and the following placeholders:
+     *
+     * - `m` - Month number.
+     * - `mm` - Month number, with leading zero for single-digit values.
+     * - `d` - Day of the month.
+     * - `dd` - Day of the month, with leading zero for single-digit values.
+     * - `yy` - Last two digits of the year.
+     * - `yyyy` - A four-digit year.
+     *
+     * Example: `mm/dd/yyyy`
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/masked-input-fields/ (linkStyle))
+     * @see [settings.maskSettings](https://surveyjs.io/form-library/documentation/api-reference/settings#maskSettings)
+     */
+    pattern: string;
+    protected updateLiterals(): void;
+    protected onPropertyValueChanged(name: string, oldValue: any, newValue: any): void;
+    getType(): string;
+    fromJSON(json: any, options?: ILoadFromJSONOptions): void;
+    _getMaskedValue(src: string, matchWholeMask?: boolean): string;
+    _getUnmaskedValue(src: string, matchWholeMask?: boolean): string;
+    processInput(args: ITextInputParams): IMaskedInputResult;
+    getMaskedValue(src: any): string;
+    getUnmaskedValue(src: string): any;
+}

package/typings/mask/mask_utils.d.ts

@@ -0,0 +1,18 @@
+export declare var numberDefinition: RegExp;
+export interface IMaskedInputResult {
+    value: string;
+    caretPosition: number;
+    cancelPreventDefault?: boolean;
+}
+export interface ITextInputParams {
+    prevValue: string;
+    selectionStart: number;
+    selectionEnd: number;
+    insertedChars: string | null;
+    inputDirection?: "forward" | "backward";
+}
+export interface IInputMask {
+    getMaskedValue(src: any): string;
+    getUnmaskedValue(src: string): any;
+    processInput(args: ITextInputParams): IMaskedInputResult;
+}

package/typings/question_baseselect.d.ts

@@ -211,6 +211,7 @@ export declare class QuestionSelectBase extends Question {
     protected updateSelectedItemValues(): void;
     private setCustomValuesIntoItems;
     protected hasUnknownValue(val: any, includeOther?: boolean, isFilteredChoices?: boolean, checkEmptyValue?: boolean): boolean;
+    protected hasUnknownValueItem(val: any, includeOther?: boolean, isFilteredChoices?: boolean, checkEmptyValue?: boolean): boolean;
     protected isValueDisabled(val: any): boolean;
     /**
      * If the clearIncorrectValuesCallback is set, it is used to clear incorrect values instead of default behaviour.

package/typings/question_dropdown.d.ts

@@ -101,6 +101,14 @@ export declare class QuestionDropdownModel extends QuestionSelectBase {
      * @see [SurveyModel.onChoicesSearch](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onChoicesSearch)
      */
     searchMode: "contains" | "startsWith";
+    /**
+     * Specifies whether to wrap long texts in choice options onto a new line.
+     *
+     * Default value: `true`
+     *
+     * Disable this property if you want the texts to be truncated with ellipsis.
+     */
+    textWrapEnabled: boolean;
     inputHasValue: boolean;
     readOnlyText: string;
     /**

package/typings/question_html.d.ts

@@ -22,4 +22,5 @@ export declare class QuestionHtmlModel extends QuestionNonValue {
     get processedHtml(): string;
     private processHtml;
     get isNewA11yStructure(): boolean;
+    get renderCssRoot(): string;
 }

package/typings/question_tagbox.d.ts

@@ -55,6 +55,7 @@ export declare class QuestionTagboxModel extends QuestionCheckboxModel {
      * Specifies whether to close the drop-down menu after a user selects a value.
      */
     closeOnSelect: number;
+    textWrapEnabled: boolean;
     /**
      * A text displayed in the input field when it doesn't have a value.
      */

package/typings/question_text.d.ts

@@ -3,6 +3,8 @@ import { HashTable } from "./helpers";
 import { SurveyError } from "./survey-error";
 import { QuestionTextBase } from "./question_textbase";
 import { CssClassBuilder } from "./utils/cssClassBuilder";
+import { InputMaskBase } from "./mask/mask_base";
+import { IInputMask } from "./mask/mask_utils";
 /**
  * A class that describes the Single-Line Input question type.
  *
@@ -12,6 +14,45 @@ export declare class QuestionTextModel extends QuestionTextBase {
     private locDataListValue;
     private minValueRunner;
     private maxValueRunner;
+    private maskInputAdapter;
+    private createMaskAdapter;
+    private deleteMaskAdapter;
+    private updateMaskAdapter;
+    onSetMaskType(newValue: string): void;
+    /**
+     * Specifies the type of a mask applied to the input.
+     *
+     * Possible values:
+     *
+     * - `"none"` (default)
+     * - `"numeric"`
+     * - `"currency"`
+     * - `"datetime"`
+     * - `"pattern"`
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/masked-input-fields/ (linkStyle))
+     * @see maskSettings
+     */
+    maskType: string;
+    get maskTypeIsEmpty(): boolean;
+    /**
+     * An object with properties that configure the mask applied to the input.
+     *
+     * Available properties depend on the specified [`maskType`](https://surveyjs.io/form-library/documentation/api-reference/text-entry-question-model#maskType) and belong to corresponding classes. Refer to the class APIs for a full list of properties:
+     *
+     * | `maskType` | Class |
+     * | ---------- | ----- |
+     * | `"numeric"` | [`InputMaskNumeric`](https://surveyjs.io/form-library/documentation/api-reference/inputmasknumeric) |
+     * | `"currency"` | [`InputMaskCurrency`](https://surveyjs.io/form-library/documentation/api-reference/inputmaskcurrency) |
+     * | `"datetime"` | [`InputMaskDateTime`](https://surveyjs.io/form-library/documentation/api-reference/inputmaskdatetime) |
+     * | `"pattern"` | [`InputMaskPattern`](https://surveyjs.io/form-library/documentation/api-reference/inputmaskpattern) |
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/masked-input-fields/ (linkStyle))
+     */
+    get maskSettings(): InputMaskBase;
+    set maskSettings(val: InputMaskBase);
+    private setNewMaskSettingsProperty;
+    protected createMaskSettings(): InputMaskBase;
     constructor(name: string);
     protected isTextValue(): boolean;
     getType(): string;
@@ -88,6 +129,12 @@ export declare class QuestionTextModel extends QuestionTextBase {
      * @see max
      */
     get isMinMaxType(): boolean;
+    _inputValue: string;
+    get maskInstance(): IInputMask;
+    get inputValue(): string;
+    set inputValue(val: string);
+    protected onChangeQuestionValue(newValue: any): void;
+    private updateInputValue;
     protected onCheckForErrors(errors: Array<SurveyError>, isOnValueChanged: boolean): void;
     protected canSetValueToSurvey(): boolean;
     protected convertFuncValuetoQuestionValue(val: any): any;
@@ -127,5 +174,7 @@ export declare class QuestionTextModel extends QuestionTextBase {
     onChange: (event: any) => void;
     onBlur: (event: any) => void;
     onFocus: (event: any) => void;
+    afterRenderQuestionElement(el: HTMLElement): void;
+    beforeDestroyQuestionElement(el: HTMLElement): void;
 }
 export declare function isMinMaxType(obj: any): boolean;

package/typings/settings.d.ts

@@ -42,7 +42,7 @@ export declare var settings: {
      * Nested properties:
      *
      * - `useLocalTimeZone`: `boolean`\
-     * Disable this property if you want internal SurveyJS functions to use methods that work with UTC date and time (`setUTCDate()` `setUTCHours()`, etc.) instead of methods that work with local date and time (`setYear`, `setHours()`, etc.). Default value: `true`.
+     * Disable this property if you want internal SurveyJS functions to use methods that work with UTC date and time (`setUTCDate()` `setUTCHours()`, etc.) instead of methods that work with local date and time (`setYear()`, `setHours()`, etc.). Default value: `true`.
      *
      * - `defaultLocaleName`: `string`\
      * A property key that stores a translation for the default locale. Default value: `"default"`.
@@ -168,7 +168,8 @@ export declare var settings: {
      * - `enabled`: `boolean`\
      * Specifies whether to add questions to the DOM only when they get into the viewport. Default value: `false`.
      *
-     * > Lazy rendering is an experimental feature that may not work as expected in all use cases.
+     * [View Demo](https://surveyjs.io/form-library/examples/survey-lazy/ (linkStyle))
+     * @see [SurveyModel.lazyRendering](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#lazyRendering)
      */
     lazyRender: {
         enabled: boolean;
@@ -550,4 +551,25 @@ export declare var settings: {
         dataList: string[];
     };
     legacyProgressBarView: boolean;
+    /**
+     * An object with properties that configure input masks.
+     *
+     * Nested properties:
+     *
+     * - `patternPlaceholderChar`: `string`\
+     * A symbol used as a placeholder for characters to be entered in [pattern masks](https://surveyjs.io/form-library/documentation/api-reference/inputmaskpattern). Default value: `"_"`.
+     *
+     * - `patternEscapeChar`: `string`\
+     * A symbol used to insert literal representations of special characters in [pattern masks](https://surveyjs.io/form-library/documentation/api-reference/inputmaskpattern). Default value: `"\\"`.
+     *
+     * - `patternDefinitions`: `<{ [key: string]: RegExp }>`\
+     * An object that maps placeholder symbols to regular expressions in [pattern masks](https://surveyjs.io/form-library/documentation/api-reference/inputmaskpattern). Default value: `{ "9": /[0-9]/, "a": /[a-zA-Z]/, "#": /[a-zA-Z0-9]/ }`.
+     */
+    maskSettings: {
+        patternPlaceholderChar: string;
+        patternEscapeChar: string;
+        patternDefinitions: {
+            [key: string]: RegExp;
+        };
+    };
 };

package/typings/survey-element.d.ts

@@ -84,6 +84,7 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
     isDragMe: boolean;
     readOnlyChangedCallback: () => void;
     static ScrollElementToTop(elementId: string, scrollIfVisible?: boolean): boolean;
+    private static ScrollElementToViewCore;
     static GetFirstNonTextElement(elements: any, removeSpaces?: boolean): any;
     static FocusElement(elementId: string): boolean;
     private static focusElementCore;

package/typings/survey-events-api.d.ts

@@ -514,9 +514,18 @@ export interface OpenFileChooserEvent {
      */
     input: HTMLInputElement;
     /**
-     * A question, panel, page, or survey for which this event is raised.
+     * A survey element (question, panel, page, or survey) or a theme JSON schema for which this event is raised.
      */
     element: Base;
+    /**
+     * The type of the element passed as the `options.element` parameter.\
+     * Possible values: `"theme"`, `"header"`, or any value returned from the [`getType()`](https://surveyjs.io/form-library/documentation/api-reference/question#getType) method.
+     */
+    elementType: String;
+    /**
+     * The name of the survey element property or theme property for which files are being selected.
+     */
+    propertyName: String;
     /**
      * A choice item for which the event is raised. This parameter has a value only when the dialog window is opened to select images for an [Image Picker](https://surveyjs.io/form-library/documentation/api-reference/image-picker-question-model) question.
      */
@@ -725,6 +734,24 @@ export interface MatrixAllowRemoveRowEvent extends MatrixDynamicQuestionEventMix
      */
     allow: boolean;
 }
+export interface MatrixDetailPanelVisibleChangedEvent extends MatrixDropdownQuestionEventMixin {
+    /**
+     * A matrix row to which the detail section belongs.
+     */
+    row: MatrixDropdownRowModelBase;
+    /**
+     * A zero-based row index.
+     */
+    rowIndex: number;
+    /**
+     * A [PanelModel](https://surveyjs.io/form-library/documentation/panelmodel) that represents the detail section.
+     */
+    detailPanel: PanelModel;
+    /**
+     * Indicates whether the detail section is visible now.
+     */
+    visible: boolean;
+}
 export interface MatrixCellCreatingBaseEvent extends MatrixDropdownQuestionEventMixin {
     /**
      * A [matrix column](https://surveyjs.io/form-library/documentation/api-reference/multi-select-matrix-column-values) to which the cell belongs.

package/typings/survey.d.ts

@@ -18,7 +18,7 @@ import { IAction, Action } from "./actions/action";
 import { ActionContainer } from "./actions/container";
 import { QuestionPanelDynamicModel } from "./question_paneldynamic";
 import { Notifier } from "./notifier";
-import { TriggerExecutedEvent, CompletingEvent, CompleteEvent, ShowingPreviewEvent, NavigateToUrlEvent, CurrentPageChangingEvent, CurrentPageChangedEvent, ValueChangingEvent, ValueChangedEvent, VariableChangedEvent, QuestionVisibleChangedEvent, PageVisibleChangedEvent, PanelVisibleChangedEvent, QuestionCreatedEvent, QuestionAddedEvent, QuestionRemovedEvent, PanelAddedEvent, PanelRemovedEvent, PageAddedEvent, ValidateQuestionEvent, SettingQuestionErrorsEvent, ValidatePanelEvent, ErrorCustomTextEvent, ValidatedErrorsOnCurrentPageEvent, ProcessHtmlEvent, GetQuestionTitleEvent, GetTitleTagNameEvent, GetQuestionNoEvent, ProgressTextEvent, TextMarkdownEvent, TextRenderAsEvent, SendResultEvent, GetResultEvent, UploadFilesEvent, DownloadFileEvent, ClearFilesEvent, LoadChoicesFromServerEvent, ProcessTextValueEvent, UpdateQuestionCssClassesEvent, UpdatePanelCssClassesEvent, UpdatePageCssClassesEvent, UpdateChoiceItemCssEvent, AfterRenderSurveyEvent, AfterRenderHeaderEvent, AfterRenderPageEvent, AfterRenderQuestionEvent, AfterRenderQuestionInputEvent, AfterRenderPanelEvent, FocusInQuestionEvent, FocusInPanelEvent, ShowingChoiceItemEvent, ChoicesLazyLoadEvent, GetChoiceDisplayValueEvent, MatrixRowAddedEvent, MatrixBeforeRowAddedEvent, MatrixRowRemovingEvent, MatrixRowRemovedEvent, MatrixAllowRemoveRowEvent, MatrixCellCreatingEvent, MatrixCellCreatedEvent, MatrixAfterCellRenderEvent, MatrixCellValueChangedEvent, MatrixCellValueChangingEvent, MatrixCellValidateEvent, DynamicPanelModifiedEvent, DynamicPanelRemovingEvent, TimerPanelInfoTextEvent, DynamicPanelItemValueChangedEvent, DynamicPanelGetTabTitleEvent, DynamicPanelCurrentIndexChangedEvent, IsAnswerCorrectEvent, DragDropAllowEvent, ScrollingElementToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, ElementContentVisibilityChangedEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent, ChoicesSearchEvent, OpenFileChooserEvent } from "./survey-events-api";
+import { TriggerExecutedEvent, CompletingEvent, CompleteEvent, ShowingPreviewEvent, NavigateToUrlEvent, CurrentPageChangingEvent, CurrentPageChangedEvent, ValueChangingEvent, ValueChangedEvent, VariableChangedEvent, QuestionVisibleChangedEvent, PageVisibleChangedEvent, PanelVisibleChangedEvent, QuestionCreatedEvent, QuestionAddedEvent, QuestionRemovedEvent, PanelAddedEvent, PanelRemovedEvent, PageAddedEvent, ValidateQuestionEvent, SettingQuestionErrorsEvent, ValidatePanelEvent, ErrorCustomTextEvent, ValidatedErrorsOnCurrentPageEvent, ProcessHtmlEvent, GetQuestionTitleEvent, GetTitleTagNameEvent, GetQuestionNoEvent, ProgressTextEvent, TextMarkdownEvent, TextRenderAsEvent, SendResultEvent, GetResultEvent, UploadFilesEvent, DownloadFileEvent, ClearFilesEvent, LoadChoicesFromServerEvent, ProcessTextValueEvent, UpdateQuestionCssClassesEvent, UpdatePanelCssClassesEvent, UpdatePageCssClassesEvent, UpdateChoiceItemCssEvent, AfterRenderSurveyEvent, AfterRenderHeaderEvent, AfterRenderPageEvent, AfterRenderQuestionEvent, AfterRenderQuestionInputEvent, AfterRenderPanelEvent, FocusInQuestionEvent, FocusInPanelEvent, ShowingChoiceItemEvent, ChoicesLazyLoadEvent, GetChoiceDisplayValueEvent, MatrixRowAddedEvent, MatrixBeforeRowAddedEvent, MatrixRowRemovingEvent, MatrixRowRemovedEvent, MatrixAllowRemoveRowEvent, MatrixDetailPanelVisibleChangedEvent, MatrixCellCreatingEvent, MatrixCellCreatedEvent, MatrixAfterCellRenderEvent, MatrixCellValueChangedEvent, MatrixCellValueChangingEvent, MatrixCellValidateEvent, DynamicPanelModifiedEvent, DynamicPanelRemovingEvent, TimerPanelInfoTextEvent, DynamicPanelItemValueChangedEvent, DynamicPanelGetTabTitleEvent, DynamicPanelCurrentIndexChangedEvent, IsAnswerCorrectEvent, DragDropAllowEvent, ScrollingElementToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, ElementContentVisibilityChangedEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent, ChoicesSearchEvent, OpenFileChooserEvent } from "./survey-events-api";
 import { QuestionMatrixDropdownModelBase } from "./question_matrixdropdownbase";
 import { QuestionMatrixDynamicModel } from "./question_matrixdynamic";
 import { QuestionFileModel } from "./question_file";
@@ -163,7 +163,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * Refer to the following help topic for information on how to implement conditional visibility: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#conditional-visibility).
      */
     onQuestionVisibleChanged: EventBase<SurveyModel, QuestionVisibleChangedEvent>;
-    onVisibleChanged: EventBase<SurveyModel, QuestionVisibleChangedEvent>;
+    onVisibleChanged: EventBase<SurveyModel, any>;
     /**
      * An event that is raised after page visibility is changed.
      *
@@ -173,7 +173,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     onPageVisibleChanged: EventBase<SurveyModel, PageVisibleChangedEvent>;
     /**
-     * An event that is raised after page visibility is changed.
+     * An event that is raised after panel visibility is changed.
      *
      * For information on event handler parameters, refer to descriptions within the interface.
      *
@@ -568,6 +568,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * This event is obsolete. Use the [`onMatrixRenderRemoveButton`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onMatrixRenderRemoveButton) event instead.
      */
     onMatrixAllowRemoveRow: EventBase<SurveyModel, MatrixAllowRemoveRowEvent>;
+    /**
+     * An event that is raised after the visibility of an [expandable detail section](https://surveyjs.io/form-library/examples/add-expandable-details-section-under-matrix-rows/) is changed. This event can be raised for [Multi-Select](https://surveyjs.io/form-library/documentation/api-reference/matrix-table-with-dropdown-list) and [Dynamic Matrix](https://surveyjs.io/form-library/documentation/api-reference/dynamic-matrix-table-question-model) questions.
+     */
+    onMatrixDetailPanelVisibleChanged: EventBase<SurveyModel, MatrixDetailPanelVisibleChangedEvent>;
     /**
      * An event that is raised before a cell in a [Multi-Select Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdropdown/) or [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/) is created. Use this event to change the type of individual matrix cells.
      * @see onAfterRenderMatrixCell
@@ -772,13 +776,12 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Specifies whether to enable lazy rendering.
      *
-     * In default mode, a survey renders the entire current page. With lazy rendering, the survey renders the page gradually as a user scrolls it. This helps reduce survey startup time and oprimizes large surveys for low-end devices.
+     * In default mode, a survey renders the entire current page. With lazy rendering, the survey renders the page gradually as a user scrolls it. This helps reduce survey startup time and optimizes large surveys for low-end devices.
      *
      * Default value: `false`
      *
      * [View Demo](https://surveyjs.io/form-library/examples/survey-lazy/ (linkStyle))
-     *
-     * > This is an experimental feature that may not work properly in certain cases.
+     * @see [settings.lazyRender](https://surveyjs.io/form-library/documentation/api-reference/settings#lazyRender)
      */
     get lazyRendering(): boolean;
     set lazyRendering(val: boolean);
@@ -1435,7 +1438,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * - `"belowHeader"` - Displays the progress bar below the survey header.
      * - `"bottom"` - Displays the progress bar below survey content.
      * - `"topBottom"` - Displays the progress bar above and below survey content.
-     * - `"auto"` - Automatically selects between `"aboveHeader"` and `"belowHeader"`.
+     * - `"auto"` - Displays the progress bar below the survey header if the header has a [background image](https://surveyjs.io/form-library/documentation/api-reference/iheader#backgroundImage) or color. Otherwise, the progress bar is displayed above the header.
      * - `"top"` - *(Obsolete)* Use the `"aboveHeader"` or `"belowHeader"` property value instead.
      * - `"both"` - *(Obsolete)* Use the `"topBottom"` property value instead.
      *
@@ -2004,10 +2007,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private onShowingPreviewChanged;
     private changeCurrentPageFromPreview;
     private originalPages;
-    protected onQuestionsOnPageModeChanged(oldValue: string): void;
+    protected onQuestionsOnPageModeChanged(oldValue: string, isFirstLoad?: boolean): void;
     private restoreOriginalPages;
     private getPageStartIndex;
-    private isCreatingPagesForPreview;
+    private isLockingUpdateOnPageModes;
     private setupPagesForPageModes;
     private createPagesForQuestionOnPageMode;
     private createSinglePage;
@@ -2152,6 +2155,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     matrixRowRemoved(question: QuestionMatrixDynamicModel, rowIndex: number, row: any): void;
     matrixRowRemoving(question: QuestionMatrixDynamicModel, rowIndex: number, row: any): boolean;
     matrixAllowRemoveRow(question: QuestionMatrixDynamicModel, rowIndex: number, row: any): boolean;
+    matrixDetailPanelVisibleChanged(question: QuestionMatrixDropdownModelBase, rowIndex: number, row: any, visible: boolean): void;
     matrixCellCreating(question: QuestionMatrixDropdownModelBase, options: any): void;
     matrixCellCreated(question: QuestionMatrixDropdownModelBase, options: any): void;
     matrixAfterCellRender(question: QuestionMatrixDropdownModelBase, options: any): void;
@@ -2184,8 +2188,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * @see onUploadFile
      */
     chooseFiles(input: HTMLInputElement, callback: (files: File[]) => void, context?: {
-        element: ISurveyElement;
+        element: Base;
         item?: any;
+        elementType?: string;
+        propertyName?: string;
     }): void;
     /**
      * Uploads files to a server.

package/typings/surveytimer.d.ts

@@ -2,7 +2,7 @@ import { Event } from "./base";
 export declare var surveyTimerFunctions: {
     setTimeout: (func: () => any) => number;
     clearTimeout: (timerId: number) => void;
-    safeTimeOut: (func: () => any, delay: number) => number;
+    safeTimeOut: (func: () => any, delay: number) => number | any;
 };
 export declare class SurveyTimer {
     private static instanceValue;