survey-core 1.12.3 → 1.12.5

package/ts3.4/typings/packages/survey-core/src/defaultCss/defaultV2Css.d.ts

@@ -711,6 +711,7 @@ export declare var defaultV2Css: {
         changeCameraButton: string;
         takePictureButton: string;
         loadingIndicator: string;
+        page: string;
     };
     signaturepad: {
         mainRoot: string;

package/ts3.4/typings/packages/survey-core/src/page.d.ts

@@ -31,6 +31,7 @@ export declare class PageModel extends PanelModelBase implements IPage {
     navigationDescription: string;
     readonly locNavigationDescription: LocalizableString;
     navigationLocStrChanged(): void;
+    getMarkdownHtml(text: string, name: string): string;
     passed: boolean;
     protected removeFromParent(): void;
     onFirstRendering(): void;
@@ -75,7 +76,7 @@ export declare class PageModel extends PanelModelBase implements IPage {
     scrollToTop(): void;
     /**
      * A time period that a respondent has spent on this page so far; measured in seconds. Applies only to [quiz surveys](https://surveyjs.io/form-library/documentation/design-survey-create-a-quiz).
-     * @see maxTimeToFinish
+     * @see timeLimit
      */
     timeSpent: number;
     /**
@@ -88,11 +89,16 @@ export declare class PageModel extends PanelModelBase implements IPage {
     /*
     * A time period that a respondent has to complete this page; measured in seconds. Applies only to [quiz surveys](https://surveyjs.io/form-library/documentation/design-survey-create-a-quiz).
     *
-    * A negative value or 0 sets an unlimited time period.
+    * Default value: 0 (time is unlimited)
     *
-    * Alternatively, you can use the `SurveyModel`'s [`maxTimeToFinishPage`](https://surveyjs.io/form-library/documentation/surveymodel#maxTimeToFinishPage) property to specify identical time periods for all survey pages.
+    * Alternatively, you can use the `SurveyModel`'s [`timeLimitPerPage`](https://surveyjs.io/form-library/documentation/surveymodel#timeLimitPerPage) property to specify identical time periods for all survey pages.
     * @see timeSpent
     */
+    timeLimit: number;
+    /*
+    * Obsolete. Use the [`timeLimit`](https://surveyjs.io/form-library/documentation/api-reference/page-model#timeLimit) property instead.
+    * @deprecated
+    */
     maxTimeToFinish: number;
     getMaxTimeToFinish(): number;
     protected onNumChanged(value: number): void;

package/ts3.4/typings/packages/survey-core/src/panel.d.ts

@@ -17,6 +17,7 @@ export declare class QuestionRowModel extends Base {
     private static getRowId;
     protected _scrollableParent: any;
     protected _updateVisibility: any;
+    private readonly allowRendering: any;
     startLazyRendering(rowContainerDiv: HTMLElement, findScrollableContainer?: typeof findScrollableParent): void;
     ensureVisibility(): void;
     stopLazyRendering(): void;
@@ -309,6 +310,8 @@ export declare class PanelModelBase extends SurveyElement<Question> implements I
     getProgressInfo(): IProgressInfo;
     readonly root: PanelModelBase;
     protected childVisibilityChanged(): void;
+    protected canRenderFirstRows(): boolean;
+    private isLazyRenderInRow;
     createRowAndSetLazy(index: number): QuestionRowModel;
     createRow(): QuestionRowModel;
     onSurveyLoad(): void;
@@ -330,12 +333,14 @@ export declare class PanelModelBase extends SurveyElement<Question> implements I
     private updateRowsVisibility;
     canBuildRows(): boolean;
     private buildRows;
-    private isLazyRenderInRow;
-    protected canRenderFirstRows(): boolean;
     getDragDropInfo(): any;
     private updateRowsOnElementRemoved;
     updateRowsRemoveElementFromRow(element: IElement, row: QuestionRowModel): void;
-    disableLazyRenderingBeforeElement(el?: IElement): void;
+    getAllRows(): Array<QuestionRowModel>;
+    private findRowAndIndexByElement;
+    private forceRenderRow;
+    forceRenderElement(el: IElement, elementsRendered?: () => void, gap?: number): void;
+    forceRenderRows(rows: Array<QuestionRowModel>, elementsRendered?: () => void): void;
     findRowByElement(el: IElement): QuestionRowModel;
     elementWidthChanged(el: IElement): void;
     readonly processedTitle: string;
@@ -455,6 +460,7 @@ export declare class PanelModelBase extends SurveyElement<Question> implements I
     readonly cssError: string;
     protected getCssError(cssClasses: any): string;
     getSerializableColumnsValue(): Array<PanelLayoutColumnModel>;
+    afterRender(el: HTMLElement): void;
     dispose(): void;
 }
 /**
@@ -534,6 +540,7 @@ export declare class PanelModel extends PanelModelBase implements IElement {
     protected createLocTitleProperty(): LocalizableString;
     protected beforeSetVisibleIndex(index: number): number;
     protected getPanelStartIndex(index: number): number;
+    private hasParentInQuestionIndex;
     protected isContinueNumbering(): boolean;
     private notifySurveyOnVisibilityChanged;
     protected getRenderedTitle(str: string): string;
@@ -573,4 +580,5 @@ export declare class PanelModel extends PanelModelBase implements IElement {
         [index: string]: string;
     }): string;
     getContainerCss(): string;
+    afterRenderCore(element: HTMLElement): void;
 }

package/ts3.4/typings/packages/survey-core/src/question.d.ts

@@ -362,7 +362,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     onCommentChange(event: any): void;
     afterRenderQuestionElement(el: HTMLElement): void;
     afterRender(el: HTMLElement): void;
-    afterRenderCore(el: HTMLElement): void;
+    afterRenderCore(element: HTMLElement): void;
     protected getCommentElementsId(): Array<string>;
     beforeDestroyQuestionElement(el: HTMLElement): void;
     readonly processedTitle: string;
@@ -538,7 +538,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     *
     * | Question type | Value type(s) |
     * | ------------- | ------------- |
-    * | Checkboxes | `Array<string \| number>` |
+    * | Checkboxes | <code>Array&lt;string &#124; number&gt;</code> |
     * | Dropdown | `string` \| `number` |
     * | Dynamic Matrix | `Array<object>` |
     * | Dynamic Panel | `Array<object>` |
@@ -546,14 +546,14 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     * | File Upload | `File` \| `Array<File>` |
     * | HTML | (no value) |
     * | Image | (no value) |
-    * | Image Picker | `Array<string \| number>` |
+    * | Image Picker | <code>Array&lt;string &#124; number&gt;</code> |
     * | 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>` |
+    * | Ranking | <code>Array&lt;string &#124; number&gt;</code> |
     * | Rating Scale | `number` \| `string` |
     * | Signature | `string` (base64-encoded image) |
     * | Single-Line Input | `string` \| `number` \| `Date` |
@@ -771,7 +771,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     readonly requiredText: string;
     addError(error: SurveyError | string): void;
     private addCustomError;
-    removeError(error: SurveyError): void;
+    removeError(error: SurveyError): boolean;
     private checkForErrors;
     protected canCollectErrors(): boolean;
     private collectErrors;

package/ts3.4/typings/packages/survey-core/src/question_baseselect.d.ts

@@ -483,9 +483,6 @@ export declare class QuestionSelectBase extends Question {
     getItemId(item: ItemValue): string;
     readonly questionName: string;
     getItemEnabled(item: ItemValue): boolean;
-    protected rootElement: HTMLElement;
-    afterRender(el: HTMLElement): void;
-    beforeDestroyQuestionElement(el: HTMLElement): void;
     private focusOtherComment;
     private prevIsOtherSelected;
     protected onValueChanged(): void;

package/ts3.4/typings/packages/survey-core/src/question_comment.d.ts

@@ -41,13 +41,10 @@ export declare class QuestionCommentModel extends QuestionTextBase {
     readonly resizeStyle: "none" | "both";
     getType(): string;
     afterRenderQuestionElement(el: HTMLElement): void;
-    updateElement(): void;
     beforeDestroyQuestionElement(el: HTMLElement): void;
     onInput(event: any): void;
     protected onBlurCore(event: any): void;
     onKeyDown(event: any): void;
-    protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
-    onValueChanged(): void;
     protected setNewValue(newValue: string): any;
     protected getValueSeparator(): string;
     readonly className: string;

package/ts3.4/typings/packages/survey-core/src/question_file.d.ts

@@ -1,6 +1,6 @@
 import { IPlainDataOptions } from "./base-interfaces";
 import { IQuestionPlainData, Question } from "./question";
-import { EventBase } from "./base";
+import { EventBase, Base } from "./base";
 import { SurveyError } from "./survey-error";
 import { ActionContainer } from "./actions/container";
 import { Action } from "./actions/action";
@@ -51,9 +51,21 @@ export declare class QuestionFileModelBase extends Question {
  *
  * [View Demo](https://surveyjs.io/form-library/examples/file-upload/ (linkStyle))
  */
+export declare class QuestionFilePage extends Base {
+    private question;
+    private index;
+    private static pageCounter;
+    private static getId;
+    items: Array<any>;
+    id: string;
+    constructor(question: QuestionFileModel, index: number);
+    readonly css: string;
+}
 export declare class QuestionFileModel extends QuestionFileModelBase {
     isDragging: boolean;
     previewValue: any[];
+    pages: QuestionFilePage[];
+    navigationDirection: "left" | "right" | "left-delete";
     indexToShow: number;
     pageSize: number;
     containsMultiplyFiles: boolean;
@@ -82,6 +94,7 @@ export declare class QuestionFileModel extends QuestionFileModelBase {
     startCameraAction: Action;
     cleanAction: Action;
     actionsContainer: ActionContainer;
+    readonly supportFileNavigator: boolean;
     private isFileLoadingValue;
     protected isFileLoading: boolean;
     readonly fileNavigatorVisible: boolean;
@@ -105,9 +118,10 @@ export declare class QuestionFileModel extends QuestionFileModelBase {
     protected updateElementCssCore(cssClasses: any): void;
     private getFileIndexCaption;
     private updateFileNavigator;
+    private updateRenderedPages;
+    private updatePages;
     private prevPreviewLength;
     private previewValueChanged;
-    isPreviewVisible(index: number): boolean;
     getType(): string;
     /*
     * Disable this property only to implement a custom preview.
@@ -235,6 +249,10 @@ export declare class QuestionFileModel extends QuestionFileModelBase {
     protected supportResponsiveness(): boolean;
     protected getObservedElementSelector(): string;
     private getFileListSelector;
+    private _renderedPages;
+    renderedPages: Array<QuestionFilePage>;
+    private getPagesAnimationOptions;
+    private pagesAnimation;
     private calcAvailableItemsCount;
     private calculatedGapBetweenItems;
     private calculatedItemWidth;

package/ts3.4/typings/packages/survey-core/src/question_matrix.d.ts

@@ -39,20 +39,27 @@ export interface IMatrixCellsOwner extends ILocalizableOwner {
     getRows(): Array<any>;
     getColumns(): Array<any>;
 }
-export declare class MatrixCells {
+export declare class MatrixCells extends Base {
     cellsOwner: IMatrixCellsOwner;
     private values;
+    private locs;
     constructor(cellsOwner: IMatrixCellsOwner);
+    getType(): string;
     readonly isEmpty: boolean;
     onValuesChanged: () => void;
+    private locNotification;
     private valuesChanged;
-    setCellText(row: any, column: any, val: string): void;
-    setDefaultCellText(column: any, val: string): void;
-    getCellLocText(row: any, column: any): LocalizableString;
-    getDefaultCellLocText(column: any, val: string): LocalizableString;
+    getDefaultCellLocText(column: any): LocalizableString;
     getCellDisplayLocText(row: any, column: any): LocalizableString;
+    private getCellLocCore;
+    private readonly defaultRowValue: any;
+    private getCellLocData;
+    private getCellLocDataFromValue;
     getCellText(row: any, column: any): string;
+    setCellText(row: any, column: any, val: string): void;
+    private updateValues;
     getDefaultCellText(column: any): string;
+    setDefaultCellText(column: any, val: string): void;
     getCellDisplayText(row: any, column: any): string;
     readonly rows: Array<any>;
     readonly columns: Array<any>;
@@ -60,6 +67,7 @@ export declare class MatrixCells {
     getJson(): any;
     setJson(value: any): void;
     locStrsChanged(): void;
+    private runFuncOnLocs;
     protected createString(): LocalizableString;
 }
 /**

package/ts3.4/typings/packages/survey-core/src/question_matrixdynamic.d.ts

@@ -96,6 +96,7 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
     * @see allowRemoveRows
     */
     minRowCount: number;
+    private onMinRowCountChanged;
     /*
     * A maximum number of rows in the matrix. Users cannot add new rows if `rowCount` equals `maxRowCount`.
     *
@@ -105,6 +106,7 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
     * @see allowAddRows
     */
     maxRowCount: number;
+    private onMaxRowCountChanged;
     /*
     * Specifies whether users are allowed to add new rows.
     *

package/ts3.4/typings/packages/survey-core/src/question_paneldynamic.d.ts

@@ -323,6 +323,7 @@ export declare class QuestionPanelDynamicModel extends Question implements IQues
     * @see allowRemovePanel
     */
     minPanelCount: number;
+    private onMinPanelCountChanged;
     /*
     * A maximum number of panels in Dynamic Panel. Users cannot add new panels if `panelCount` equals `maxPanelCount`.
     *
@@ -332,6 +333,7 @@ export declare class QuestionPanelDynamicModel extends Question implements IQues
     * @see allowAddPanel
     */
     maxPanelCount: number;
+    private onMaxPanelCountChanged;
     /*
     * Specifies whether users are allowed to add new panels.
     *

package/ts3.4/typings/packages/survey-core/src/question_ranking.d.ts

@@ -30,6 +30,7 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
     onSurveyValueChanged(newValue: any): void;
     onSurveyLoad(): void;
     protected onVisibleChoicesChanged: () => void;
+    updateValueFromSurvey(newValue: any, clearData: boolean): void;
     localeChanged: () => void;
     private addToValueByVisibleChoices;
     private removeFromValueByVisibleChoices;

package/ts3.4/typings/packages/survey-core/src/question_rating.d.ts

@@ -116,6 +116,7 @@ export declare class QuestionRatingModel extends Question {
     private createRenderedRateItems;
     renderedRateItems: Array<RenderedRatingItem>;
     private createRateValues;
+    private getRatingItemValue;
     private correctValue;
     getType(): string;
     protected getFirstInputElementId(): string;
@@ -262,6 +263,7 @@ export declare class QuestionRatingModel extends Question {
     readonly searchEnabled: boolean;
     renderedValue: any;
     isItemSelected(item: ItemValue): boolean;
+    private visibleChoicesValue;
     readonly visibleChoices: ItemValue[];
     readonly readOnlyText: any;
     needResponsiveWidth(): boolean;
@@ -271,6 +273,7 @@ export declare class QuestionRatingModel extends Question {
     protected getDesktopRenderAs(): string;
     private dropdownListModelValue;
     dropdownListModel: DropdownListModel;
+    protected onBlurCore(event: any): void;
     protected updateCssClasses(res: any, css: any): void;
     protected calcCssClasses(css: any): any;
     themeChanged(theme: ITheme): void;

package/ts3.4/typings/packages/survey-core/src/survey-element.d.ts

@@ -1,4 +1,4 @@
-import { Base } from "./base";
+import { Base, EventBase } from "./base";
 import { IAction } from "./actions/action";
 import { AdaptiveActionContainer } from "./actions/adaptive-container";
 import { ISurveyElement, IPage, IPanel, IProgressInfo, ISurvey, ISurveyData, ISurveyImpl, ITextProcessor, ITitleOwner } from "./base-interfaces";
@@ -103,8 +103,10 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
     dragTypeOverMe: DragTypeOverMeEnum;
     isDragMe: boolean;
     readOnlyChangedCallback: () => void;
-    static ScrollElementToTop(elementId: string, scrollIfVisible?: boolean, scrollIntoViewOptions?: ScrollIntoViewOptions): boolean;
-    static ScrollElementToViewCore(el: HTMLElement, checkLeft: boolean, scrollIfVisible?: boolean, scrollIntoViewOptions?: ScrollIntoViewOptions): boolean;
+    private static IsNeedScrollIntoView;
+    static ScrollIntoView(el: HTMLElement, scrollIntoViewOptions?: ScrollIntoViewOptions, doneCallback?: () => void): void;
+    static ScrollElementToTop(elementId: string, scrollIfVisible?: boolean, scrollIntoViewOptions?: ScrollIntoViewOptions, doneCallback?: () => void): boolean;
+    static ScrollElementToViewCore(el: HTMLElement, checkLeft: boolean, scrollIfVisible?: boolean, scrollIntoViewOptions?: ScrollIntoViewOptions, doneCallback?: () => void): boolean;
     static GetFirstNonTextElement(elements: any, removeSpaces?: boolean): any;
     static FocusElement(elementId: string): boolean;
     private static focusElementCore;
@@ -219,6 +221,7 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
     readonly survey: ISurvey;
     getSurvey(live?: boolean): ISurvey;
     protected setSurveyCore(value: ISurvey): void;
+    readonly skeletonHeight: string;
     isContentElement: boolean;
     isEditableTemplateElement: boolean;
     isInteractiveDesignElement: boolean;
@@ -409,5 +412,18 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
     private animationCollapsed;
     renderedIsExpanded: boolean;
     protected getIsAnimationAllowed(): boolean;
+    onAfterRenderElement: EventBase<SurveyElement<E>, any>;
+    afterRenderCore(element: HTMLElement): void;
+    dispose(): void;
+}
+export declare class RenderingCompletedAwaiter {
+    private _elements;
+    private _renderedHandler;
+    constructor(_elements: Array<SurveyElement>, _renderedHandler: () => void, waitingTimeout?: number);
+    private _elementsToRenderCount;
+    private _elementsToRenderTimer;
+    private _elementRenderedHandler;
+    private stopWaitingForElementsRendering;
+    private visibleElementsRendered;
     dispose(): void;
 }

package/ts3.4/typings/packages/survey-core/src/survey.d.ts

@@ -625,11 +625,17 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     * An event that is raised every second while the timer is running.
     *
     * Use the [`timeSpent`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#timeSpent) property to find out how many seconds have elapsed.
-    * @see maxTimeToFinish
-    * @see maxTimeToFinishPage
-    * @see showTimerPanel
+    * @see timeLimit
+    * @see timeLimitPerPage
+    * @see showTimer
+    * @see timerLocation
     * @see startTimer
     */
+    onTimerTick: EventBase<SurveyModel, {}>;
+    /**
+     * Obsolete. Use the [`onTimerTick`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onTimerTick) event instead.
+     * @deprecated
+     */
     onTimer: EventBase<SurveyModel, {}>;
     onTimerPanelInfoText: EventBase<SurveyModel, any>;
     /**
@@ -773,6 +779,18 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     headerView: "advanced" | "basic";
     protected insertAdvancedHeader(advHeader: Cover): void;
+    /**
+     * Specifies whether the [Complete page](https://surveyjs.io/form-library/documentation/design-survey/create-a-multi-page-survey#complete-page) should display the [survey header](https://surveyjs.io/form-library/examples/brand-your-survey-header/).
+     *
+     * Possible values:
+     *
+     * - `true` - Displays the survey header on the Complete page.
+     * - `false` - Hides the header when users reach the Complete page.
+     * - `"auto"` (default) - Displays a header with the basic view, but hides a header with the advanced view (see the [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/itheme#headerView) property description).
+     *
+     * > This property cannot be specified in the survey JSON schema. Use dot notation to specify it.
+     */
+    showHeaderOnCompletePage: true | false | "auto";
     private getNavigationCss;
     private lazyRenderingValue;
     showBrandInfo: boolean;
@@ -791,7 +809,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     readonly isLazyRendering: boolean;
     lazyRenderingFirstBatchSizeValue: number;
     lazyRenderingFirstBatchSize: number;
-    disableLazyRenderingBeforeElement(el: IElement): void;
+    protected _isLazyRenderingSuspended: boolean;
+    readonly isLazyRenderingSuspended: boolean;
+    protected suspendLazyRendering(): void;
+    protected releaseLazyRendering(): void;
     private updateLazyRenderingRowsOnRemovingElements;
     /*
     * A list of triggers in the survey.
@@ -1292,8 +1313,9 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Calculates a given [expression](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions) and returns a result value.
      * @param expression An expression to calculate.
+     * @param callback A callback function that you can use to access the calculation result if the expression uses asynchronous functions.
      */
-    runExpression(expression: string): any;
+    runExpression(expression: string, callback?: (res: any) => void): any;
     /**
      * Calculates a given [expression](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions) and returns `true` or `false`.
      * @param expression An expression to calculate.
@@ -2159,7 +2181,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private getUpdatedPanelTitleActions;
     private getUpdatedPageTitleActions;
     getUpdatedMatrixRowActions(question: QuestionMatrixDropdownModelBase, row: any, actions: Array<IAction>): IAction[];
-    scrollElementToTop(element: ISurveyElement, question: Question, page: PageModel, id: string, scrollIfVisible?: boolean, scrollIntoViewOptions?: ScrollIntoViewOptions): any;
+    skeletonHeight: number;
+    scrollElementToTop(element: ISurveyElement, question: Question, page: PageModel, id: string, scrollIfVisible?: boolean, scrollIntoViewOptions?: ScrollIntoViewOptions, passedRootElement?: HTMLElement): any;
     /**
      * Opens a dialog window for users to select files.
      * @param input A [file input HTML element](https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement).
@@ -2568,38 +2591,56 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     getCorrectedAnswers(): number;
     getInCorrectedAnswers(): number;
     /*
-    * Displays the timer panel and specifies its position. Applies only to [quiz surveys](https://surveyjs.io/form-library/documentation/design-survey-create-a-quiz).
+    * Obsolete. Use the [`showTimer`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#showTimer) and [`timerLocation`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#timerLocation) properties instead.
+    * @deprecated
+    */
+    showTimerPanel: string;
+    /*
+    * Specifies the timer's visibility. Applies only to [quiz surveys](https://surveyjs.io/form-library/documentation/design-survey-create-a-quiz).
     *
-    * Possible values:
+    * Default value: `false`
     *
-    * - `"top"` - Displays the timer panel at the top of the survey.
-    * - `"bottom"` - Displays the timer panel at the bottom of the survey.
-    * - `"none"` (default) - Hides the timer panel.
+    * If you set this property to `true`, the timer starts automatically when the survey begins. To specify time limits, use the [`timeLimit`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#timeLimit) and [`timeLimitPerPage`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#timeLimitPerPage) properties.
     *
-    * If the timer panel is displayed, the timer starts automatically when the survey begins. To specify time limits, use the [`maxTimeToFinish`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#maxTimeToFinish) and [`maxTimeToFinishPage`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#maxTimeToFinishPage) properties.
+    * The timer displays information about time spent on an individual page and the entire survey. If you want to display only the page timer or the survey timer, set the [`timerInfoMode`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#timerInfoMode) property to `"page"` or `"survey"`.
     *
-    * The timer panel displays information about time spent on an individual page and the entire survey. If you want to display only the page timer or the survey timer, set the [`showTimerPanelMode`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#showTimerPanelMode) property to `"page"` or `"survey"`.
-    * @see startTimer
-    * @see stopTimer
+    * You can enable the timer without displaying it. In this case, you need to specify the required time limits and use the [`startTimer()`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#startTimer) and [`stopTimer()`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#stopTimer) methods to control the timer.
+    * @see timerLocation
     * @see timeSpent
-    * @see onTimer
+    * @see onTimerTick
     */
-    showTimerPanel: string;
+    showTimer: boolean;
+    /*
+    * Specifies the timer's position relative to the survey. Applies only if the [`showTimer`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#showTimer) property is set to `true`.
+    *
+    * Possible values:
+    *
+    * - `"top"` (default) - Displays the timer at the top of the survey.
+    * - `"bottom"` - Displays the timer at the bottom of the survey.
+    * @see onTimerTick
+    */
+    timerLocation: string;
     readonly isTimerPanelShowingOnTop: boolean;
     readonly isTimerPanelShowingOnBottom: boolean;
     /*
-    * Specifies whether the timer panel displays timers for the current page, the entire survey, or both. Applies only if the timer panel is [visible](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#showTimerPanel).
+    * Specifies whether the timer panel displays timers for the current page, the entire survey, or both. Applies only if the timer panel is [visible](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#showTimer).
     *
     * Possible values:
     *
     * - `"survey"` - Displays only the survey timer.
     * - `"page"` - Displays only the page timer.
-    * - `"all"` (default) - Displays both the survey and page timers.
+    * - `"combined"` (default) - Displays both the survey and page timers.
     * @see timeSpent
-    * @see onTimer
+    * @see onTimerTick
     * @see startTimer
     * @see stopTimer
     */
+    timerInfoMode: string;
+    private getTimerInfoVal;
+    /*
+    * Obsolete. Use the [`timerInfoMode`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#timerInfoMode) property instead.
+    * @deprecated
+    */
     showTimerPanelMode: string;
     gridLayoutEnabled: boolean;
     /*
@@ -2643,20 +2684,20 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Starts a timer that calculates how many seconds a respondent has spent on the survey. Applies only to [quiz surveys](https://surveyjs.io/form-library/documentation/design-survey-create-a-quiz).
      * @see stopTimer
-     * @see maxTimeToFinish
-     * @see maxTimeToFinishPage
+     * @see timeLimit
+     * @see timeLimitPerPage
      * @see timeSpent
-     * @see onTimer
+     * @see onTimerTick
      */
     startTimer(): void;
     startTimerFromUI(): void;
     /**
      * Stops the timer. Applies only to [quiz surveys](https://surveyjs.io/form-library/documentation/design-survey-create-a-quiz).
      * @see startTimer
-     * @see maxTimeToFinish
-     * @see maxTimeToFinishPage
+     * @see timeLimit
+     * @see timeLimitPerPage
      * @see timeSpent
-     * @see onTimer
+     * @see onTimerTick
      */
     stopTimer(): void;
     /*
@@ -2665,34 +2706,44 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     * Assign a number to this property if you need to start the quiz timer from a specific time (for instance, if you want to continue an interrupted quiz).
     *
     * You can also find out how many seconds a respondent has spent on an individual survey page. To do this, use the [`timeSpent`](https://surveyjs.io/form-library/documentation/api-reference/page-model#timeSpent) property of a [`PageModel`](https://surveyjs.io/form-library/documentation/api-reference/page-model) object.
-    * @see maxTimeToFinish
-    * @see maxTimeToFinishPage
+    * @see timeLimit
+    * @see timeLimitPerPage
     * @see startTimer
     */
     timeSpent: number;
     /*
     * A time period that a respondent has to complete the survey; measured in seconds. Applies only to [quiz surveys](https://surveyjs.io/form-library/documentation/design-survey-create-a-quiz).
     *
-    * A negative value or 0 sets an unlimited time period.
+    * Default value: 0 (time is unlimited)
     *
     * [View Demo](https://surveyjs.io/form-library/examples/make-quiz-javascript/ (linkStyle))
-    * @see maxTimeToFinishPage
+    * @see timeLimitPerPage
     * @see startTimer
     * @see timeSpent
     */
+    timeLimit: number;
+    /*
+    * Obsolete. Use the [`timeLimit`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#timeLimit) property instead.
+    * @deprecated
+    */
     maxTimeToFinish: number;
     /*
     * A time period that a respondent has to complete each survey page; measured in seconds. Applies only to [quiz surveys](https://surveyjs.io/form-library/documentation/design-survey-create-a-quiz).
     *
-    * A negative value or 0 sets an unlimited time period.
+    * Default value: 0 (time is unlimited)
     *
-    * You can also use `PageModel`'s [`maxTimeToFinish`](https://surveyjs.io/form-library/documentation/api-reference/page-model#maxTimeToFinish) property to specify a time period for an individual survey page.
+    * You can also use `PageModel`'s [`timeLimit`](https://surveyjs.io/form-library/documentation/api-reference/page-model#timeLimit) property to specify a time period for an individual survey page.
     *
     * [View Demo](https://surveyjs.io/form-library/examples/make-quiz-javascript/ (linkStyle))
-    * @see maxTimeToFinish
+    * @see timeLimit
     * @see startTimer
     * @see timeSpent
     */
+    timeLimitPerPage: number;
+    /*
+    * Obsolete. Use the [`timeLimitPerPage`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#timeLimitPerPage) property instead.
+    * @deprecated
+    */
     maxTimeToFinishPage: number;
     private doTimer;
     readonly inSurvey: boolean;

package/ts3.4/typings/packages/survey-core/src/surveyTimerModel.d.ts

@@ -18,7 +18,7 @@ export interface ISurveyTimerText {
     onCurrentPageChanged: EventBase<SurveyModel>;
 }
 export declare class SurveyTimerModel extends Base {
-    onTimer: (page: PageModel) => void;
+    onTimerTick: (page: PageModel) => void;
     private surveyValue;
     constructor(survey: ISurvey);
     text: string;

package/ts3.4/typings/packages/survey-core/src/surveytimer.d.ts

@@ -14,6 +14,7 @@ export declare class SurveyTimer {
     private listenerCounter;
     private timerId;
     private prevTimeInMs;
+    onTimerTick: EventBase<SurveyTimer, SurveyTimerEvent>;
     onTimer: EventBase<SurveyTimer, SurveyTimerEvent>;
     start(func?: (timer: SurveyTimer, options: SurveyTimerEvent) => void): void;
     stop(func?: (timer: SurveyTimer, options: SurveyTimerEvent) => any): void;