survey-core 1.9.122 → 1.9.124

package/typings/question_paneldynamic.d.ts

@@ -339,11 +339,25 @@ 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
      */
     get allowAddPanel(): boolean;
     set allowAddPanel(val: 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
+     */
+    get newPanelPosition(): string;
+    set newPanelPosition(val: string);
     /**
      * Specifies whether users are allowed to delete panels.
      *
@@ -486,6 +500,8 @@ export declare class QuestionPanelDynamicModel extends Question implements IQues
      * @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 allowAddPanel
+     * @see newPanelPosition
      */
     addPanel(index?: number): PanelModel;
     private updateValueOnAddingPanel;
@@ -501,6 +517,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/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;
@@ -55,6 +54,9 @@ export declare class QuestionTagboxModel extends QuestionCheckboxModel {
     get clearCaption(): string;
     set clearCaption(value: string);
     get locClearCaption(): LocalizableString;
+    get readOnlyText(): string;
+    set readOnlyText(val: string);
+    get locReadOnlyText(): LocalizableString;
     getType(): string;
     get ariaRole(): string;
     get popupModel(): PopupModel;

package/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/typings/survey-element.d.ts

@@ -219,7 +219,8 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
     set readOnly(val: boolean);
     protected onReadOnlyChanged(): void;
     private get css();
-    cssClassesValue: any;
+    get cssClassesValue(): any;
+    set cssClassesValue(val: any);
     private ensureCssClassesValue;
     /**
      * Returns an object in which keys are UI elements and values are CSS classes applied to them.

package/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";
@@ -875,15 +875,24 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * - `"none"` - Hides the navigation buttons. This setting may be useful if you [implement custom external navigation](https://surveyjs.io/form-library/examples/external-form-navigation-system/).
      * @see goNextPageAutomatic
      * @see showPrevButton
+     * @see showCompleteButton
      */
     get showNavigationButtons(): string | any;
     set showNavigationButtons(val: string | any);
     /**
      * Specifies whether to display the Previous button. Set this property to `false` if respondents should not move backward along the survey.
      * @see showNavigationButtons
+     * @see showCompleteButton
      */
     get showPrevButton(): boolean;
     set showPrevButton(val: boolean);
+    /**
+     * Specifies whether to display the Complete button. Set this property to `false` if respondents should not complete the survey.
+     * @see showNavigationButtons
+     * @see showPrevButton
+     */
+    get showCompleteButton(): boolean;
+    set showCompleteButton(val: boolean);
     /**
      * Gets or sets the visibility of the table of contents.
      *
@@ -2372,7 +2381,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;
@@ -2485,6 +2494,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     panelVisibilityChanged(panel: PanelModel, newValue: boolean): void;
     questionCreated(question: Question): any;
     questionAdded(question: Question, index: number, parentPanel: any, rootPanel: any): void;
+    private canFireAddElement;
     questionRemoved(question: Question): void;
     questionRenamed(question: IQuestion, oldName: string, oldValueName: string): any;
     private questionHashes;

package/typings/utils/devices.d.ts

@@ -1,3 +1,8 @@
 export declare const IsMobile: boolean;
+export declare var mouseInfo: {
+    readonly isTouch: boolean;
+    readonly hasTouchEvent: boolean;
+    hasMouse: boolean;
+};
 export declare let IsTouch: boolean;
 export declare function _setIsTouch(val: boolean): void;

package/typings/validator.d.ts

@@ -122,6 +122,9 @@ export declare class RegexValidator extends SurveyValidator {
      */
     get regex(): string;
     set regex(val: string);
+    get insensitive(): boolean;
+    set insensitive(val: boolean);
+    private createRegExp;
 }
 /**
  * Validate e-mail address in the text input