survey-core 1.9.126 → 1.9.128

package/typings/survey.d.ts

@@ -18,7 +18,7 @@ import { IAction, Action } from "./actions/action";
 import { ActionContainer } from "./actions/container";
 import { QuestionPanelDynamicModel } from "./question_paneldynamic";
 import { Notifier } from "./notifier";
-import { TriggerExecutedEvent, CompletingEvent, CompleteEvent, ShowingPreviewEvent, NavigateToUrlEvent, CurrentPageChangingEvent, CurrentPageChangedEvent, ValueChangingEvent, ValueChangedEvent, VariableChangedEvent, QuestionVisibleChangedEvent, PageVisibleChangedEvent, PanelVisibleChangedEvent, QuestionCreatedEvent, QuestionAddedEvent, QuestionRemovedEvent, PanelAddedEvent, PanelRemovedEvent, PageAddedEvent, ValidateQuestionEvent, SettingQuestionErrorsEvent, ValidatePanelEvent, ErrorCustomTextEvent, ValidatedErrorsOnCurrentPageEvent, ProcessHtmlEvent, GetQuestionTitleEvent, GetTitleTagNameEvent, GetQuestionNoEvent, ProgressTextEvent, TextMarkdownEvent, TextRenderAsEvent, SendResultEvent, GetResultEvent, UploadFilesEvent, DownloadFileEvent, ClearFilesEvent, LoadChoicesFromServerEvent, ProcessTextValueEvent, UpdateQuestionCssClassesEvent, UpdatePanelCssClassesEvent, UpdatePageCssClassesEvent, UpdateChoiceItemCssEvent, AfterRenderSurveyEvent, AfterRenderHeaderEvent, AfterRenderPageEvent, AfterRenderQuestionEvent, AfterRenderQuestionInputEvent, AfterRenderPanelEvent, FocusInQuestionEvent, FocusInPanelEvent, ShowingChoiceItemEvent, ChoicesLazyLoadEvent, GetChoiceDisplayValueEvent, MatrixRowAddedEvent, MatrixBeforeRowAddedEvent, MatrixRowRemovingEvent, MatrixRowRemovedEvent, MatrixAllowRemoveRowEvent, MatrixCellCreatingEvent, MatrixCellCreatedEvent, MatrixAfterCellRenderEvent, MatrixCellValueChangedEvent, MatrixCellValueChangingEvent, MatrixCellValidateEvent, DynamicPanelModifiedEvent, DynamicPanelRemovingEvent, TimerPanelInfoTextEvent, DynamicPanelItemValueChangedEvent, DynamicPanelGetTabTitleEvent, DynamicPanelCurrentIndexChangedEvent, IsAnswerCorrectEvent, DragDropAllowEvent, ScrollingElementToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, ElementContentVisibilityChangedEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent } 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, ChoicesSearchEvent } from "./survey-events-api";
 import { QuestionMatrixDropdownModelBase } from "./question_matrixdropdownbase";
 import { QuestionMatrixDynamicModel } from "./question_matrixdynamic";
 import { QuestionFileModel } from "./question_file";
@@ -514,6 +514,12 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * [View Demo](https://surveyjs.io/form-library/examples/lazy-loading-dropdown/ (linkStyle))
      */
     onChoicesLazyLoad: EventBase<SurveyModel, ChoicesLazyLoadEvent>;
+    /**
+     * An event that is raised each time a search string in a [Dropdown](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model) or [Tag Box](https://surveyjs.io/form-library/documentation/api-reference/dropdown-tag-box-model) question changes. Use this event to implement custom filtering of choice options.
+     * @see [QuestionDropdownModel.searchEnabled](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model#searchEnabled)
+     * @see [QuestionDropdownModel.searchMode](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model#searchMode)
+     */
+    onChoicesSearch: EventBase<SurveyModel, ChoicesSearchEvent>;
     /**
      * Use this event to load a display text for the [default choice item](https://surveyjs.io/form-library/documentation/questiondropdownmodel#defaultValue) in [Dropdown](https://surveyjs.io/form-library/documentation/questiondropdownmodel) and [Tag Box](https://surveyjs.io/form-library/documentation/questiontagboxmodel) questions.
      *
@@ -749,17 +755,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     containerCss: string;
     fitToContainer: boolean;
     /**
-     * Specifies whether the survey header uses only basic appearance settings or applies advanced settings from the survey theme.
-     *
-     * Possible values:
-     *
-     * - `"basic"` (default)\
-     * A basic header view applies only the [`title`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#title), [`description`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#description), and logo-related properties ([`logo`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#logo), [`logoPosition`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#logoPosition), etc.).
-     *
-     * - `"advanced"`\
-     * An advanced header view applies the same properties as the basic view, plus [header settings](https://surveyjs.io/form-library/documentation/api-reference/iheader) from the [survey theme](https://surveyjs.io/form-library/documentation/api-reference/itheme#header). The advanced view features a more flexible header layout, a capability to specify a background image, and other settings that give a more professional look to the survey header.
-     *
-     * [View Demo](https://surveyjs.io/form-library/examples/brand-your-survey-header/ (linkStyle))
+     * This property is obsolete. Use the [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/itheme#headerView) property within a theme instead.
      */
     headerView: "advanced" | "basic";
     protected insertAdvancedHeader(advHeader: Cover): void;
@@ -1420,15 +1416,21 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     get showQuestionNumbers(): string | boolean;
     set showQuestionNumbers(value: string | boolean);
+    private progressBarValue;
+    get progressBar(): any;
     /**
      * Controls the visibility of the progress bar and specifies its position.
      *
      * Possible values:
      *
      * - `"off"` (default) - Hides the progress bar.
-     * - `"top"` - Displays the progress bar above survey content.
+     * - `"aboveHeader"` - Displays the progress bar above the survey header.
+     * - `"belowHeader"` - Displays the progress bar below the survey header.
      * - `"bottom"` - Displays the progress bar below survey content.
-     * - `"both"` - Displays the progress bar above and below survey content.
+     * - `"topBottom"` - Displays the progress bar above and below survey content.
+     * - `"auto"` - Automatically selects between `"aboveHeader"` and `"belowHeader"`.
+     * - `"top"` - *(Obsolete)* Use the `"aboveHeader"` or `"belowHeader"` property value instead.
+     * - `"both"` - *(Obsolete)* Use the `"topBottom"` property value instead.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/navigation-default/ (linkStyle))
      * @see progressBarType
@@ -1445,13 +1447,30 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * - `"questions"` - The number of answered questions.
      * - `"requiredQuestions"` - The number of answered [required questions](https://surveyjs.io/form-library/documentation/api-reference/question#isRequired).
      * - `"correctQuestions"` - The number of correct questions in a [quiz](https://surveyjs.io/form-library/documentation/design-survey/create-a-quiz).
-     * - `"buttons"` - Adds jump links to the progress bar.
+     * - `"buttons"` - *(Obsolete)* Use the `"pages"` property value with the [`progressBarShowPageTitles`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#progressBarShowPageTitles) property set to `true` instead.
+     *
+     * > When `progressBarType` is set to `"pages"`, you can also enable the [`progressBarShowPageNumbers`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#progressBarShowPageNumbers) and [`progressBarShowPageTitles`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#progressBarShowPageTitles) properties if you want to display page numbers and titles in the progress bar.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/navigation-buttons/ (linkStyle))
      * @see progressValue
      */
     get progressBarType(): string;
     set progressBarType(newValue: string);
+    private get progressBarComponentName();
+    /**
+     * Specifies whether the progress bar displays page titles. Applies only when the [progress bar is visible](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#showProgressBar) and [`progressBarType`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#progressBarType) is `"pages"`.
+     *
+     * Default value: `false`
+     * @see progressBarShowPageNumbers
+     */
+    progressBarShowPageTitles: boolean;
+    /**
+     * Specifies whether the progress bar displays page numbers. Applies only when the [progress bar is visible](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#showProgressBar) and [`progressBarType`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#progressBarType) is `"pages"`.
+     *
+     * Default value: `false`
+     * @see progressBarShowPageTitles
+     */
+    progressBarShowPageNumbers: boolean;
     get isShowProgressBarOnTop(): boolean;
     get isShowProgressBarOnBottom(): boolean;
     getProgressTypeComponent(): string;
@@ -2136,7 +2155,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     getUpdatedMatrixRowActions(question: QuestionMatrixDropdownModelBase, row: any, actions: Array<IAction>): IAction[];
     scrollElementToTop(element: ISurveyElement, question: Question, page: PageModel, id: string, scrollIfVisible?: boolean): any;
     /**
-     * Uploads a file to server.
+     * Uploads files to a server.
      *
      * The following code shows how to call this method:
      *
@@ -2355,6 +2374,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private conditionRunnerCounter;
     private conditionUpdateVisibleIndexes;
     private conditionNotifyElementsOnAnyValueOrVariableChanged;
+    /**
+     * Recalculates all [expressions](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions) in the survey.
+     */
+    runExpressions(): void;
     private runConditions;
     private runConditionOnValueChanged;
     private runConditionsCore;
@@ -2386,6 +2409,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private updateVisibleIndexes;
     private updatePageVisibleIndexes;
     fromJSON(json: any, options?: ILoadFromJSONOptions): void;
+    startLoadingFromJson(json?: any): void;
     setJsonObject(jsonObj: any): void;
     private isEndLoadingFromJson;
     endLoadingFromJson(): void;
@@ -2730,7 +2754,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *
      * This method accepts an object with the following layout element properties:
      *
-     * - `id`: `string` | `"timerpanel"` | `"progress-buttons"` | `"progress-questions"` | `"progress-pages"` | `"progress-correctquestions"` | `"progress-requiredquestions"` | `"toc-navigation"` | `"navigationbuttons"`\
+     * - `id`: `string` | `"timerpanel"` | `"progress-buttons"` | `"progress-questions"` | `"progress-pages"` | `"progress-correctquestions"` | `"progress-requiredquestions"` | `"toc-navigation"` | `"buttons-navigation"`\
      * A layout element identifier. You can use possible values to access and relocate or customize predefined layout elements.
      *
      * - `container`: `"header"` | `"footer"` | `"left"` | `"right"` | `"contentTop"` | `"contentBottom"`\

package/typings/surveyProgressButtons.d.ts

@@ -1,9 +1,9 @@
-import { SurveyModel } from "./survey";
-export declare class SurveyProgressButtonsModel {
-    private survey;
-    constructor(survey: SurveyModel);
-    isListElementClickable(index: number): boolean;
-    getListElementCss(index: number): string;
-    getScrollButtonCss(hasScroller: boolean, isLeftScroll: boolean): string;
-    clickListElement(index: number): void;
-}
+import { SurveyModel } from "./survey";
+export declare class SurveyProgressButtonsModel {
+    private survey;
+    constructor(survey: SurveyModel);
+    isListElementClickable(index: number): boolean;
+    getListElementCss(index: number): string;
+    getScrollButtonCss(hasScroller: boolean, isLeftScroll: boolean): string;
+    clickListElement(index: number): void;
+}

package/typings/surveyStrings.d.ts

@@ -24,6 +24,8 @@ export declare var surveyStrings: {
     startSurveyText: string;
     otherItemText: string;
     noneItemText: string;
+    refuseItemText: string;
+    dontKnowItemText: string;
     selectAllItemText: string;
     progressText: string;
     indexText: string;

package/typings/themes.d.ts

@@ -56,7 +56,7 @@ export interface ITheme {
      */
     backgroundOpacity?: number;
     /**
-     * An object with [advanced survey header settings](https://surveyjs.io/form-library/documentation/api-reference/iheader). Applies when `SurveyModel`'s [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#headerView) property is set to `"advanced"`.
+     * An object with [advanced survey header settings](https://surveyjs.io/form-library/documentation/api-reference/iheader). Applies when the [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/itheme#headerView) property is set to `"advanced"`.
      */
     header?: IHeader;
     /**
@@ -83,7 +83,7 @@ export interface ITheme {
 /**
  * A survey header configuration interface.
  *
- * An `IHeader` object configures advanced survey header appearance settings. To apply them, you need to assign the object to the [`header`](https://surveyjs.io/form-library/documentation/api-reference/itheme#header) property of your theme configuration and set `SurveyModel`'s [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#headerView) property to `"advanced"`.
+ * An `IHeader` object configures advanced survey header appearance settings. To apply them, you need to assign the object to the [`header`](https://surveyjs.io/form-library/documentation/api-reference/itheme#header) property of your theme configuration and set the [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/itheme#headerView) property to `"advanced"`.
  */
 export interface IHeader {
     /**

package/typings/trigger.d.ts

@@ -16,6 +16,8 @@ export declare class Trigger extends Base {
     get id(): number;
     getType(): string;
     toString(): string;
+    isGhost: boolean;
+    protected get isInternal(): boolean;
     get operator(): string;
     set operator(value: string);
     get value(): any;

package/typings/utils/popup.d.ts

@@ -16,10 +16,7 @@ export interface ISize {
 export declare class PopupUtils {
     static bottomIndent: number;
     static calculatePosition(targetRect: ClientRect, height: number, width: number, verticalPosition: VerticalPosition, horizontalPosition: HorizontalPosition, showPointer: boolean, positionMode?: PositionMode): INumberPosition;
-    static getCorrectedVerticalDimensions(top: number, height: number, windowHeight: number): {
-        height: number;
-        top: number;
-    };
+    static getCorrectedVerticalDimensions(top: number, height: number, windowHeight: number, verticalPosition: VerticalPosition): any;
     static updateHorizontalDimensions(left: number, width: number, windowWidth: number, horizontalPosition: HorizontalPosition, positionMode?: PositionMode, margins?: {
         left: number;
         right: number;

package/typings/utils/utils.d.ts

@@ -1,6 +1,6 @@
 declare function compareVersions(a: any, b: any): number;
 declare function confirmAction(message: string): boolean;
-declare function confirmActionAsync(message: string, funcOnYes: () => void, funcOnNo?: () => void): void;
+declare function confirmActionAsync(message: string, funcOnYes: () => void, funcOnNo?: () => void, locale?: string): void;
 declare function detectIEBrowser(): boolean;
 declare function detectIEOrEdge(): boolean;
 declare function loadFileFromBase64(b64Data: string, fileName: string): void;
@@ -40,5 +40,5 @@ export declare class Logger {
     log(action: string): void;
     get result(): string;
 }
-export declare function showConfirmDialog(message: string, callback: (res: boolean) => void, applyTitle?: string): boolean;
+export declare function showConfirmDialog(message: string, callback: (res: boolean) => void, applyTitle?: string, locale?: string): boolean;
 export { mergeValues, getElementWidth, isContainerVisible, classesToSelector, compareVersions, confirmAction, confirmActionAsync, detectIEOrEdge, detectIEBrowser, loadFileFromBase64, isMobile, isShadowDOM, getElement, isElementVisible, findScrollableParent, scrollElementByChildId, navigateToUrl, wrapUrlForBackgroundImage, createSvg, getIconNameFromProxy, increaseHeightByContent, getOriginalEvent, preventDefaults, findParentByClassNames, getFirstVisibleChild, };