survey-core 1.9.121 → 1.9.123

package/ts3.4/typings/question_paneldynamic.d.ts

@@ -321,11 +321,24 @@ export declare class QuestionPanelDynamicModel extends Question implements IQues
     * Specifies whether users are allowed to add new panels.
     *
     * Default value: `true`
+    *
+    * By default, users add new panels to the end. If you want to let users insert a new panel after the current panel, set the [`newPanelPosition`](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model#newPanelPosition) property to `"next"`.
     * @see canAddPanel
     * @see allowRemovePanel
     */
     allowAddPanel: boolean;
     /*
+    * Specifies the position of newly added panels.
+    *
+    * Possible values:
+    *
+    * - `"last"` (default) - New panels are added to the end.
+    * - `"next"` - New panels are inserted after the current panel.
+    * @see allowAddPanel
+    * @see addPanel
+    */
+    newPanelPosition: string;
+    /*
     * Specifies whether users are allowed to delete panels.
     *
     * Default value: `true`
@@ -453,13 +466,15 @@ export declare class QuestionPanelDynamicModel extends Question implements IQues
      */
     addPanelUI(): PanelModel;
     /**
-     * Add a new dynamic panel based on the template Panel.
-     * @see template
+     * Adds a new panel based on the [template](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model#template).
+     * @param index *(Optional)* An index at which to insert the new panel. `undefined` adds the panel to the end or inserts it after the current panel if [`renderMode`](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model#renderMode) is `"tab"`. A negative index (for instance, -1) adds the panel to the end in all cases, regardless of the `renderMode` value.
      * @see panelCount
      * @see panels
-     * @see renderMode
+     * @see allowAddPanel
+     * @see newPanelPosition
      */
-    addPanel(): PanelModel;
+    addPanel(index?: number): PanelModel;
+    private updateValueOnAddingPanel;
     private canLeaveCurrentPanel;
     private copyValue;
     /**
@@ -472,6 +487,7 @@ export declare class QuestionPanelDynamicModel extends Question implements IQues
      *
      */
     removePanelUI(value: any): void;
+    isRequireConfirmOnDelete(val: any): boolean;
     /**
      * Switches Dynamic Panel to the next panel. Returns `true` in case of success, or `false` if `renderMode` is `"list"` or the current panel contains validation errors.
      * @see renderMode

package/ts3.4/typings/question_rating.d.ts

@@ -124,17 +124,19 @@ export declare class QuestionRatingModel extends Question {
     protected getPlainDataCalculatedValue(propName: string): any;
     /*
     * Specifies a description for the minimum (first) rate value.
+    * @see rateDescriptionLocation
+    * @see displayRateDescriptionsAsExtremeItems
     * @see rateValues
     * @see rateMin
-    * @see displayRateDescriptionsAsExtremeItems
     */
     minRateDescription: string;
     readonly locMinRateDescription: LocalizableString;
     /*
     * Specifies a description for the maximum (last) rate value.
+    * @see rateDescriptionLocation
+    * @see displayRateDescriptionsAsExtremeItems
     * @see rateValues
     * @see rateMax
-    * @see displayRateDescriptionsAsExtremeItems
     */
     maxRateDescription: string;
     readonly locMaxRateDescription: LocalizableString;
@@ -143,15 +145,14 @@ export declare class QuestionRatingModel extends Question {
     readonly hasMinLabel: boolean;
     readonly hasMaxLabel: boolean;
     /**
-    * Specifies whether to display `minRateDescription` and `maxRateDescription` values as captions for buttons that correspond to the extreme (first and last) rate values.
+    * Specifies whether to display [`minRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#minRateDescription) and [`maxRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#maxRateDescription) values as captions for buttons that correspond to the extreme (first and last) rate values.
     *
     * Default value: `false`
     *
     * If this property is disabled, the `minRateDescription` and `maxRateDescription` values are displayed as plain non-clickable texts.
     *
     * If any of the `minRateDescription` and `maxRateDescription` properties is empty, the corresponding rate value's `value` or `text` is displayed as a button caption.
-    * @see minRateDescription
-    * @see maxRateDescription
+    * @see rateDescriptionLocation
     * @see rateMin
     * @see rateMax
     * @see rateValues
@@ -170,6 +171,18 @@ export declare class QuestionRatingModel extends Question {
     * @see rateType
     */
     displayMode: "dropdown" | "buttons" | "auto";
+    /**
+    * Specifies the alignment of [`minRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#minRateDescription) and [`maxRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#maxRateDescription) texts.
+    *
+    * Possible values:
+    *
+    * - `"leftRight"` (default) - Aligns `minRateDescription` to the left of rate values and `maxRateDescription` to their right.
+    * - `"top"` - Displays the descriptions above the minimum and maximum rate values.
+    * - `"bottom"` - Displays both descriptions below the minimum and maximum rate values.
+    * - `"topBottom"` - Displays `minRateDescription` above the minimum rate value and `maxRateDescription` below the maximum rate value.
+    * @see displayRateDescriptionsAsExtremeItems
+    */
+    rateDescriptionLocation: "leftRight" | "top" | "bottom" | "topBottom";
     /**
      * Specifies the visual representation of rate values.
      *

package/ts3.4/typings/question_tagbox.d.ts

@@ -14,7 +14,6 @@ export declare class QuestionTagboxModel extends QuestionCheckboxModel {
     private itemDisplayNameMap;
     constructor(name: string);
     locStrsChanged(): void;
-    readOnlyText: string;
     private updateReadOnlyText;
     protected getDefaultItemComponent(): string;
     onSurveyLoad(): void;
@@ -53,6 +52,8 @@ export declare class QuestionTagboxModel extends QuestionCheckboxModel {
     readonly locPlaceholder: LocalizableString;
     clearCaption: string;
     readonly locClearCaption: LocalizableString;
+    readOnlyText: string;
+    readonly locReadOnlyText: LocalizableString;
     getType(): string;
     readonly ariaRole: string;
     readonly popupModel: PopupModel;

package/ts3.4/typings/settings.d.ts

@@ -34,13 +34,7 @@ export declare var settings: {
         showEmptyDescriptions: boolean;
         showEmptyTitles: boolean;
     };
-    /**
-     * This property is obsolete. Use the [`settings.designMode.showEmptyDescriptions`](https://surveyjs.io/form-library/documentation/api-reference/settings#designMode) property instead.
-     */
     allowShowEmptyDescriptionInDesignMode: boolean;
-    /**
-     * This property is obsolete. Use the [`settings.designMode.showEmptyTitles`](https://surveyjs.io/form-library/documentation/api-reference/settings#designMode) property instead.
-     */
     allowShowEmptyTitleInDesignMode: boolean;
     /**
      * An object that contains properties related to localization.
@@ -61,17 +55,8 @@ export declare var settings: {
         storeDuplicatedTranslations: boolean;
         defaultLocaleName: string;
     };
-    /**
-     * This property is obsolete. Use the [`settings.localization.useLocalTimeZone`](https://surveyjs.io/form-library/documentation/api-reference/settings#localization) property instead.
-     */
     useLocalTimeZone: boolean;
-    /**
-     * This property is obsolete. Use the [`settings.localization.storeDuplicatedTranslations`](https://surveyjs.io/form-library/documentation/api-reference/settings#localization) property instead.
-     */
     storeDuplicatedTranslations: boolean;
-    /**
-     * This property is obsolete. Use the [`settings.localization.defaultLocaleName`](https://surveyjs.io/form-library/documentation/api-reference/settings#localization) property instead.
-     */
     defaultLocaleName: string;
     /**
      * An object with properties that configure surveys when they work with a web service.
@@ -82,36 +67,38 @@ export declare var settings: {
      * Specifies whether to encode URL parameters when you access a web service. Default value: `true`.
      *
      * - `cacheLoadedChoices`: `boolean`\
-     * Specifies whether to cache [choices](https://surveyjs.io/form-library/documentation/api-reference/checkbox-question-model#choicesByUrl) loaded from a web service. Default value: `true`.
+     * Specifies whether to cache [choices loaded from a web service](https://surveyjs.io/form-library/documentation/api-reference/questionselectbase#choicesByUrl). Default value: `true`.
      *
      * - `disableQuestionWhileLoadingChoices`: `boolean`\
      * Disables a question while its choices are being loaded from a web service. Default value: `false`.
      *
      * - `surveyServiceUrl`: `string`\
      * The URL of the SurveyJS Service API endpoint.
+     *
+     * - `onBeforeRequestChoices`: `(sender: ChoicesRestful, options: { request: XMLHttpRequest })`\
+     * An event that is raised before a request for choices is send. Applies to questions with a specified [`choiceByUrl`](https://surveyjs.io/form-library/documentation/api-reference/questionselectbase#choicesByUrl) property. Use the `options.request` parameter to access and modify the `XMLHttpRequest` object. For instance, you can add authentication headers to it:
+     *
+     *     ```js
+     *     import { settings } from "survey-core";
+     *
+     *     settings.web.onBeforeSendRequest = (sender, options) => {
+     *       options.request.setRequestHeader('RequestVerificationToken', requestVerificationToken);
+     *     };
+     *     ```
      */
     web: {
+        onBeforeRequestChoices: (sender: any, options: {
+            request: XMLHttpRequest;
+        }) => void;
         encodeUrlParams: boolean;
         cacheLoadedChoices: boolean;
         disableQuestionWhileLoadingChoices: boolean;
         surveyServiceUrl: string;
     };
-    /**
-     * This property is obsolete. Use the [`settings.web.encodeUrlParams`](https://surveyjs.io/form-library/documentation/api-reference/settings#web) property instead.
-     */
     webserviceEncodeParameters: boolean;
-    /**
-     * This property is obsolete. Use the [`settings.web.cacheLoadedChoices`](https://surveyjs.io/form-library/documentation/api-reference/settings#web) property instead.
-     */
     useCachingForChoicesRestful: boolean;
     useCachingForChoicesRestfull: boolean;
-    /**
-     * This property is obsolete. Use the [`settings.web.disableQuestionWhileLoadingChoices`](https://surveyjs.io/form-library/documentation/api-reference/settings#web) property instead.
-     */
     disableOnGettingChoicesFromWeb: boolean;
-    /**
-     * This property is obsolete. Use the [`settings.web.surveyServiceUrl`](https://surveyjs.io/form-library/documentation/api-reference/settings#web) property instead.
-     */
     surveyServiceUrl: string;
     /**
      * An object that contains properties related to [triggers](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#conditional-survey-logic-triggers).
@@ -134,17 +121,8 @@ export declare var settings: {
         executeCompleteOnValueChanged: boolean;
         executeSkipOnValueChanged: boolean;
     };
-    /**
-     * This property is obsolete. Use the [`settings.triggers.executeCompleteOnValueChanged`](https://surveyjs.io/form-library/documentation/api-reference/settings#triggers) property instead.
-     */
     executeCompleteTriggerOnValueChanged: boolean;
-    /**
-     * This property is obsolete. Use the [`settings.triggers.changeNavigationButtonsOnComplete`](https://surveyjs.io/form-library/documentation/api-reference/settings#triggers) property instead.
-     */
     changeNavigationButtonsOnCompleteTrigger: boolean;
-    /**
-     * This property is obsolete. Use the [`settings.triggers.executeSkipOnValueChanged`](https://surveyjs.io/form-library/documentation/api-reference/settings#triggers) property instead.
-     */
     executeSkipTriggerOnValueChanged: boolean;
     /**
      * An object that contains properties related to JSON serialization.
@@ -179,17 +157,8 @@ export declare var settings: {
         itemValueSerializeDisplayText: boolean;
         localizableStringSerializeAsObject: boolean;
     };
-    /**
-     * This property is obsolete. Use the [`settings.serialization.itemValueSerializeAsObject`](https://surveyjs.io/form-library/documentation/api-reference/settings#serialization) property instead.
-     */
     itemValueAlwaysSerializeAsObject: boolean;
-    /**
-     * This property is obsolete. Use the [`settings.serialization.itemValueSerializeDisplayText`](https://surveyjs.io/form-library/documentation/api-reference/settings#serialization) property instead.
-     */
     itemValueAlwaysSerializeText: boolean;
-    /**
-     * This property is obsolete. Use the [`settings.serialization.localizableStringSerializeAsObject`](https://surveyjs.io/form-library/documentation/api-reference/settings#serialization) property instead.
-     */
     serializeLocalizableStringAsObject: boolean;
     /**
      * An object that configures lazy rendering.
@@ -205,9 +174,6 @@ export declare var settings: {
         enabled: boolean;
         firstBatchSize: number;
     };
-    /**
-     * This property is obsolete. Use the [`settings.lazyRender.enabled`](https://surveyjs.io/form-library/documentation/api-reference/settings#lazyRender) property instead.
-     */
     lazyRowsRendering: boolean;
     lazyRowsRenderingStartRow: number;
     /**
@@ -258,29 +224,11 @@ export declare var settings: {
         };
         rateSize: "small" | "normal";
     };
-    /**
-     * This property is obsolete. Use the [`settings.matrix.defaultRowName`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     matrixDefaultRowName: string;
-    /**
-     * This property is obsolete. Use the [`settings.matrix.defaultCellType`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     matrixDefaultCellType: string;
-    /**
-     * This property is obsolete. Use the [`settings.matrix.totalsSuffix`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     matrixTotalValuePostFix: string;
-    /**
-     * This property is obsolete. Use the [`settings.matrix.maxRowCount`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     matrixMaximumRowCount: number;
-    /**
-     * This property is obsolete. Use the [`settings.matrix.maxRowCountInCondition`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     matrixMaxRowCountInCondition: number;
-    /**
-     * This property is obsolete. Use the [`settings.matrix.renderRemoveAsIcon`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     matrixRenderRemoveAsIcon: boolean;
     /**
      * An object with properties that apply to [Dynamic Panel](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model) questions.
@@ -299,13 +247,7 @@ export declare var settings: {
         maxPanelCount: number;
         maxPanelCountInCondition: number;
     };
-    /**
-     * This property is obsolete. Use the [`settings.panel.maxPanelCountInCondition`](https://surveyjs.io/form-library/documentation/api-reference/settings#panel) property instead.
-     */
     panelDynamicMaxPanelCountInCondition: number;
-    /**
-     * This property is obsolete. Use the [`settings.panel.maxPanelCount`](https://surveyjs.io/form-library/documentation/api-reference/settings#panel) property instead.
-     */
     panelMaximumPanelCount: number;
     /**
      * An object with properties that configure questions in read-only mode.
@@ -323,13 +265,7 @@ export declare var settings: {
         commentRenderMode: string;
         textRenderMode: string;
     };
-    /**
-     * This property is obsolete. Use the [`settings.readOnly.commentRenderMode`](https://surveyjs.io/form-library/documentation/api-reference/settings#readOnly) property instead.
-     */
     readOnlyCommentRenderMode: string;
-    /**
-     * This property is obsolete. Use the [`settings.readOnly.textRenderMode`](https://surveyjs.io/form-library/documentation/api-reference/settings#readOnly) property instead.
-     */
     readOnlyTextRenderMode: string;
     /**
      * An object with properties that configure question numbering.
@@ -346,13 +282,7 @@ export declare var settings: {
         includeQuestionsWithHiddenNumber: boolean;
         includeQuestionsWithHiddenTitle: boolean;
     };
-    /**
-     * This property is obsolete. Use the [`settings.numbering.includeQuestionsWithHiddenTitle`](https://surveyjs.io/form-library/documentation/api-reference/settings#numbering) property instead.
-     */
     setQuestionVisibleIndexForHiddenTitle: boolean;
-    /**
-     * This property is obsolete. Use the [`settings.numbering.includeQuestionsWithHiddenNumber`](https://surveyjs.io/form-library/documentation/api-reference/settings#numbering) property instead.
-     */
     setQuestionVisibleIndexForHiddenNumber: boolean;
     /**
      * Specifies an action to perform when users press the Enter key within a survey.

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

@@ -827,15 +827,17 @@ export interface DynamicPanelItemValueChangedEvent extends PanelDynamicQuestionE
      */
     panel: PanelModel;
 }
-export interface DynamicPanelGetTabTitleEvent extends PanelDynamicQuestionEventMixin {
+export interface DynamicPanelCurrentIndexChangedEvent extends PanelDynamicQuestionEventMixin {
     /**
-     * A panel whose tab title is being rendered.
+     * A panel for which the event is raised.
      */
     panel: PanelModel;
     /**
      * The panel's index in the [`visiblePanels`](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model#visiblePanels) array of the Dynamic Panel.
      */
     visiblePanelIndex: number;
+}
+export interface DynamicPanelGetTabTitleEvent extends DynamicPanelCurrentIndexChangedEvent {
     /**
      * A tab title. You can change this parameter's value.
      */

package/ts3.4/typings/survey.d.ts

@@ -1,6 +1,6 @@
 import { JsonError } from "./jsonobject";
 import { Base, EventBase } from "./base";
-import { ISurvey, ISurveyData, ISurveyImpl, ITextProcessor, IQuestion, IPanel, IElement, IPage, ISurveyErrorOwner, ISurveyElement, IProgressInfo, IFindElement, ISurveyLayoutElement, IPlainDataOptions, LayoutElementContainer, IValueItemCustomPropValues } from "./base-interfaces";
+import { ISurvey, ISurveyData, ISurveyImpl, ITextProcessor, IQuestion, IPanel, IElement, IPage, ISurveyErrorOwner, ISurveyElement, IProgressInfo, IFindElement, ISurveyLayoutElement, IPlainDataOptions, LayoutElementContainer, IValueItemCustomPropValues, ILoadFromJSONOptions } from "./base-interfaces";
 import { SurveyElementCore } from "./survey-element";
 import { ISurveyTriggerOwner, SurveyTrigger, Trigger } from "./trigger";
 import { CalculatedValue } from "./calculatedValue";
@@ -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, IsAnswerCorrectEvent, DragDropAllowEvent, ScrollingElementToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, ElementContentVisibilityChangedEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent } 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, 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 } from "./survey-events-api";
 import { QuestionMatrixDropdownModelBase } from "./question_matrixdropdownbase";
 import { QuestionMatrixDynamicModel } from "./question_matrixdynamic";
 import { QuestionFileModel } from "./question_file";
@@ -630,6 +630,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * [View Demo](https://surveyjs.io/form-library/examples/tabbed-interface-for-duplicate-group-option/ (linkStyle))
      */
     onGetDynamicPanelTabTitle: EventBase<SurveyModel, DynamicPanelGetTabTitleEvent>;
+    /**
+     * An event that is raised after the current panel is changed in a [Dynamic Panel](https://surveyjs.io/form-library/examples/questiontype-paneldynamic/) question.
+     */
+    onDynamicPanelCurrentIndexChanged: EventBase<SurveyModel, DynamicPanelCurrentIndexChangedEvent>;
     /**
      * An event that is raised to define whether a question answer is correct. Applies only to [quiz surveys](https://surveyjs.io/form-library/documentation/design-survey/create-a-quiz).
      */
@@ -1445,7 +1449,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Merges a specified data object with the object from the [`data`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#data) property.
      *
-     * Refer to the following help topic for more information: [Merge Question Values](https://surveyjs.io/form-library/documentation/design-survey/merge-question-values).
+     * Refer to the following help topic for more information: [Populate Form Fields | Multiple Question Values](https://surveyjs.io/form-library/documentation/design-survey/pre-populate-form-fields#multiple-question-values).
      *
      * @param data A data object to merge. It should have the following structure: `{ questionName: questionValue, ... }`
      * @see setValue
@@ -1866,6 +1870,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     protected onQuestionsOnPageModeChanged(oldValue: string): void;
     private restoreOriginalPages;
     private getPageStartIndex;
+    private isCreatingPagesForPreview;
     private setupPagesForPageModes;
     private createPagesForQuestionOnPageMode;
     private createSinglePage;
@@ -2024,6 +2029,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     dynamicPanelRemoving(question: QuestionPanelDynamicModel, panelIndex: number, panel: PanelModel): boolean;
     dynamicPanelItemValueChanged(question: IQuestion, options: any): void;
     dynamicPanelGetTabTitle(question: IQuestion, options: any): void;
+    dynamicPanelCurrentIndexChanged(question: IQuestion, options: any): void;
     dragAndDropAllow(options: DragDropAllowEvent): boolean;
     elementContentVisibilityChanged(element: ISurveyElement): void;
     getUpdatedPanelFooterActions(panel: PanelModel, actions: Array<IAction>, question?: QuestionPanelDynamicModel): Array<IAction>;
@@ -2044,13 +2050,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *   question,
      *   question.name,
      *   question.value,
-     *   (status, data) => {
-     *     if (status === "success") {
-     *       // Handle success
-     *     }
-     *     if (status === "error") {
-     *       // Handle error
-     *     }
+     *   (data, errors) => {
+     *     // ...
      *   }
      * );
      * ```
@@ -2135,7 +2136,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Returns a question with a specified [`name`](https://surveyjs.io/form-library/documentation/api-reference/question#name).
      * @param name A question name
-     * @param caseInsensitive (Optional) A Boolean value that specifies case sensitivity when searching for the question. Default value: `false` (uppercase and lowercase letters are treated as distinct).
+     * @param caseInsensitive *(Optional)* A Boolean value that specifies case sensitivity when searching for the question. Default value: `false` (uppercase and lowercase letters are treated as distinct).
      * @returns A question with a specified name.
      * @see getAllQuestions
      * @see getQuestionByValueName
@@ -2147,7 +2148,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *
      * > Since `valueName` does not have to be unique, multiple questions can have the same `valueName` value. In this case, the `getQuestionByValueName()` method returns the first such question. If you need to get all questions with the same `valueName`, call the `getQuestionsByValueName()` method.
      * @param valueName A question's `valueName` property value.
-     * @param caseInsensitive (Optional) A Boolean value that specifies case sensitivity when searching for the question. Default value: `false` (uppercase and lowercase letters are treated as distinct).
+     * @param caseInsensitive *(Optional)* A Boolean value that specifies case sensitivity when searching for the question. Default value: `false` (uppercase and lowercase letters are treated as distinct).
      * @returns A question with a specified `valueName`.
      * @see getAllQuestions
      * @see getQuestionByName
@@ -2156,7 +2157,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Returns all questions with a specified [`valueName`](https://surveyjs.io/form-library/documentation/api-reference/question#valueName). If a question's `valueName` is undefined, its [`name`](https://surveyjs.io/form-library/documentation/api-reference/question#name) property is used.
      * @param valueName A question's `valueName` property value.
-     * @param caseInsensitive (Optional) A Boolean value that specifies case sensitivity when searching for the questions. Default value: `false` (uppercase and lowercase letters are treated as distinct).
+     * @param caseInsensitive *(Optional)* A Boolean value that specifies case sensitivity when searching for the questions. Default value: `false` (uppercase and lowercase letters are treated as distinct).
      * @returns An array of questions with a specified `valueName`.
      * @see getAllQuestions
      * @see getQuestionByName
@@ -2166,7 +2167,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Returns an array of questions with specified [names](https://surveyjs.io/form-library/documentation/api-reference/question#name).
      * @param names An array of question names.
-     * @param caseInsensitive (Optional) A Boolean value that specifies case sensitivity when searching for the questions. Default value: `false` (uppercase and lowercase letters are treated as distinct).
+     * @param caseInsensitive *(Optional)* A Boolean value that specifies case sensitivity when searching for the questions. Default value: `false` (uppercase and lowercase letters are treated as distinct).
      * @returns An array of questions with specified names
      * @see getAllQuestions
      */
@@ -2211,7 +2212,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Returns a [panel](https://surveyjs.io/form-library/documentation/api-reference/panel-model) with a specified [`name`](https://surveyjs.io/form-library/documentation/api-reference/panel-model#name).
      * @param name A panel name.
-     * @param caseInsensitive (Optional) A Boolean value that specifies case sensitivity when searching for the panel. Default value: `false` (uppercase and lowercase letters are treated as distinct).
+     * @param caseInsensitive *(Optional)* A Boolean value that specifies case sensitivity when searching for the panel. Default value: `false` (uppercase and lowercase letters are treated as distinct).
      * @returns A panel with a specified name.
      * @see getAllPanels
      */
@@ -2288,7 +2289,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private resetVisibleIndexes;
     private updateVisibleIndexes;
     private updatePageVisibleIndexes;
-    fromJSON(json: any): void;
+    fromJSON(json: any, options?: ILoadFromJSONOptions): void;
     setJsonObject(jsonObj: any): void;
     private isEndLoadingFromJson;
     endLoadingFromJson(): void;

package/typings/base-interfaces.d.ts

@@ -149,6 +149,7 @@ export interface ISurvey extends ITextProcessor, ISurveyErrorOwner {
     dynamicPanelRemoving(question: IQuestion, panelIndex: number, panel: IPanel): boolean;
     dynamicPanelItemValueChanged(question: IQuestion, options: any): any;
     dynamicPanelGetTabTitle(question: IQuestion, options: any): any;
+    dynamicPanelCurrentIndexChanged(question: IQuestion, options: any): void;
     dragAndDropAllow(options: DragDropAllowEvent): boolean;
     scrollElementToTop(element: ISurveyElement, question: IQuestion, page: IPage, id: string, scrollIfVisible?: boolean): any;
     runExpression(expression: string): any;
@@ -303,3 +304,6 @@ export interface IPlainDataOptions {
         propertyName: string;
     }>;
 }
+export interface ILoadFromJSONOptions {
+    validatePropertyValues?: boolean;
+}

package/typings/base.d.ts

@@ -2,7 +2,7 @@ import { ILocalizableOwner, LocalizableString } from "./localizablestring";
 import { HashTable } from "./helpers";
 import { JsonObjectProperty } from "./jsonobject";
 import { ItemValue } from "./itemvalue";
-import { IElement, IFindElement, IProgressInfo, ISurvey } from "./base-interfaces";
+import { IElement, IFindElement, IProgressInfo, ISurvey, ILoadFromJSONOptions } from "./base-interfaces";
 import { ExpressionRunner } from "./conditions";
 export declare class Bindings {
     private obj;
@@ -70,7 +70,7 @@ export declare class Base {
      * Returns `true` if a passed `value` is an empty string, array, or object or if it equals to `undefined` or `null`.
      *
      * @param value A value to be checked.
-     * @param trimString (Optional) When this parameter is `true`, the method ignores whitespace characters at the beginning and end of a string value. Pass `false` to disable this functionality.
+     * @param trimString *(Optional)* When this parameter is `true`, the method ignores whitespace characters at the beginning and end of a string value. Pass `false` to disable this functionality.
      */
     isValueEmpty(value: any, trimString?: boolean): boolean;
     protected trimValue(value: any): any;
@@ -176,9 +176,11 @@ export declare class Base {
      * The JSON object should contain only serializable properties of this SurveyJS object. Event handlers and properties that do not belong to the SurveyJS object are ignored.
      *
      * @param json A JSON object with properties that you want to apply to the current SurveyJS object.
+     * @param options An object with configuration options.
+     * @param {boolean} options.validatePropertyValues Pass `true` if you want to validate property values. Use the [`jsonErrors`](#jsonErrors) array to access validation errors.
      * @see toJSON
      */
-    fromJSON(json: any): void;
+    fromJSON(json: any, options?: ILoadFromJSONOptions): void;
     onSurveyLoad(): void;
     /**
      * Creates a new object that has the same type and properties as the current SurveyJS object.
@@ -202,7 +204,7 @@ export declare class Base {
      * If the property is not found or does not have a value, this method returns either `undefined`, `defaultValue` specified in the property configuration, or a value passed as the `defaultValue` parameter.
      *
      * @param name A property name.
-     * @param defaultValue (Optional) A value to return if the property is not found or does not have a value.
+     * @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;
     getDefaultPropertyValue(name: string): any;
@@ -247,14 +249,14 @@ export declare class Base {
      * Registers a function to call when a property value changes.
      * @param propertyNames An array of one or multiple property names.
      * @param handler A function to call when one of the listed properties change.
-     * @param key (Optional) A key that identifies the current registration. If a function for one of the properties is already registered with the same key, the function will be overwritten. You can also use the key to subsequently unregister handlers.
+     * @param key *(Optional)* A key that identifies the current registration. If a function for one of the properties is already registered with the same key, the function will be overwritten. You can also use the key to subsequently unregister handlers.
      * @see unregisterPropertyChangedHandlers
      */
     registerPropertyChangedHandlers(propertyNames: Array<string>, handler: any, key?: string): void;
     /**
      * Unregisters value change event handlers for the specified properties.
      * @param propertyNames An array of one or multiple property names.
-     * @param key (Optional) A key of the registration that you want to cancel.
+     * @param key *(Optional)* A key of the registration that you want to cancel.
      * @see registerPropertyChangedHandlers
      */
     unregisterPropertyChangedHandlers(propertyNames: Array<string>, key?: string): void;

package/typings/choicesRestful.d.ts

@@ -19,7 +19,7 @@ import { SurveyError } from "./survey-error";
  * }
  * ```
  *
- * Typically, you should assign this object to a question's [`choicesByUrl`](https://surveyjs.io/Documentation/Library?id=QuestionSelectBase#choicesByUrl) property.
+ * Typically, you should assign this object to a question's [`choicesByUrl`](https://surveyjs.io/Documentation/Library?id=QuestionSelectBase#choicesByUrl) property. You can also specify additional application-wide settings using the [`settings.web`](https://surveyjs.io/form-library/documentation/api-reference/settings#web) object.
  */
 export declare class ChoicesRestful extends Base {
     private static cacheText;
@@ -31,9 +31,12 @@ export declare class ChoicesRestful extends Base {
     private static sendingSameRequests;
     private static addSameRequest;
     private static unregisterSameRequests;
-    static onBeforeSendRequest: (sender: ChoicesRestful, options: {
+    static get onBeforeSendRequest(): (sender: ChoicesRestful, options: {
         request: XMLHttpRequest;
     }) => void;
+    static set onBeforeSendRequest(val: (sender: ChoicesRestful, options: {
+        request: XMLHttpRequest;
+    }) => void);
     private static getCachedItemsResult;
     private lastObjHash;
     private isRunningValue;
@@ -131,6 +134,11 @@ export declare class ChoicesRestful extends Base {
      */
     get imageLinkName(): string;
     set imageLinkName(val: string);
+    /**
+     * Specifies whether the service is allowed to return an empty response or an empty array in a response.
+     *
+     * Default value: `false`
+     */
     get allowEmptyResponse(): boolean;
     set allowEmptyResponse(val: boolean);
     get attachOriginalItems(): boolean;

package/typings/defaultCss/defaultV2Css.d.ts

@@ -506,6 +506,9 @@ export declare var defaultV2Css: {
         rootDropdown: string;
         root: string;
         rootWrappable: string;
+        rootLabelsTop: string;
+        rootLabelsBottom: string;
+        rootLabelsDiagonal: string;
         item: string;
         itemOnError: string;
         itemHover: string;

package/typings/entries/chunks/model.d.ts

@@ -9,7 +9,7 @@ export { Helpers, HashTable } from "../../helpers";
 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, IPlainDataOptions as IPlainData, IShortcutText } from "../../base-interfaces";
+export { ISurvey, ISurveyElement, IElement, IQuestion, IPage, IPanel, ISurveyData, ITitleOwner, ISurveyLayoutElement, IPlainDataOptions as IPlainData, IShortcutText, ILoadFromJSONOptions } from "../../base-interfaces";
 export { SurveyError } from "../../survey-error";
 export { SurveyElementCore, SurveyElement, DragTypeOverMeEnum } from "../../survey-element";
 export { CalculatedValue } from "../../calculatedValue";

package/typings/header.d.ts

@@ -77,4 +77,5 @@ export declare class Cover extends Base {
     protected propertyValueChanged(name: string, oldValue: any, newValue: any): void;
     calculateActualHeight(logoHeight: number, titleHeight: number, descriptionHeight: number): number;
     processResponsiveness(width: number): void;
+    get hasBackground(): boolean;
 }

package/typings/itemvalue.d.ts

@@ -61,9 +61,9 @@ export declare class ItemValue extends BaseAction implements ILocalizableOwner,
     set visibleIf(val: string);
     get enableIf(): string;
     set enableIf(val: string);
-    get isVisible(): any;
+    get isVisible(): boolean;
     setIsVisible(val: boolean): void;
-    get isEnabled(): any;
+    get isEnabled(): boolean;
     setIsEnabled(val: boolean): void;
     addUsedLocales(locales: Array<string>): void;
     locStrsChanged(): void;