survey-react 1.9.111 → 1.9.112

package/survey.min.css

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - Survey JavaScript library v1.9.111
+ * surveyjs - Survey JavaScript library v1.9.112
  * Copyright (c) 2015-2023 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */

package/survey.react.d.ts

@@ -4428,7 +4428,6 @@ declare module "question_expression" {
         set precision(val: number);
         private roundValue;
         protected getValueAsStr(val: any): string;
-        protected convertToCorrectValue(val: any): any;
     }
     export function getCurrecyCodes(): Array<string>;
 }
@@ -4516,6 +4515,10 @@ declare module "question_matrixdropdowncolumn" {
         set resetValueIf(val: string);
         get defaultValueExpression(): string;
         set defaultValueExpression(val: string);
+        get setValueIf(): string;
+        set setValueIf(val: string);
+        get setValueExpession(): string;
+        set setValueExpession(val: string);
         get isUnique(): boolean;
         set isUnique(val: boolean);
         get showInMultipleColumns(): boolean;
@@ -5810,6 +5813,77 @@ declare module "question_paneldynamic" {
         protected calcCssClasses(css: any): any;
     }
 }
+declare module "themes" {
+    export type ImageFit = "auto" | "contain" | "cover";
+    export type ImageAttachment = "fixed" | "scroll";
+    /**
+     * A theme configuration interface.
+     *
+     * `ITheme` objects are used to apply predefined themes or create custom themes. Refer to the following help topic for more information:
+     *
+     * [Themes & Styles](https://surveyjs.io/form-library/documentation/manage-default-themes-and-styles (linkStyle))
+     */
+    export interface ITheme {
+        /**
+         * A theme name.
+         */
+        themeName?: string;
+        /**
+         * A color palette.
+         *
+         * Possible values:
+         *
+         * - `"light"`
+         * - `"dark"`
+         */
+        colorPalette?: string;
+        /**
+         * A Boolean value that specifies whether survey questions are displayed within panels (`false`) or without them (`true`).
+         */
+        isPanelless?: boolean;
+        /**
+         * An image to display as survey background. This property accepts a hyperlink or a data URL.
+         */
+        backgroundImage?: string;
+        /**
+         * A string value that specifies how to resize the [background image](#backgroundImage) to fit it into its container.
+         *
+         * Possible values:
+         *
+         * - `"auto"`
+         * - `"contain"`
+         * - `"cover"`
+         *
+         * Refer to the description of the [`background-size`](https://developer.mozilla.org/en-US/docs/Web/CSS/background-size#values) CSS property values on MDN for detailed information on the possible values.
+         */
+        backgroundImageFit?: ImageFit;
+        /**
+         * A string value that specifies whether the [background image](#backgroundImage) is fixed in its position or scrolled along with the survey.
+         *
+         * Possible values:
+         *
+         * - `"fixed"`
+         * - `"scroll"`
+         */
+        backgroundImageAttachment?: ImageAttachment;
+        /**
+         * A value from 0 to 1 that specifies how transparent the [background image](#backgroundImage) should be: 0 makes the image completely transparent, and 1 makes it opaque.
+         */
+        backgroundOpacity?: number;
+        /**
+         * An object with survey header settings.
+         */
+        header?: {
+            [index: string]: any;
+        };
+        /**
+         * An object with CSS variables.
+         */
+        cssVariables?: {
+            [index: string]: string;
+        };
+    }
+}
 declare module "survey-events-api" {
     import { IAction } from "actions/action";
     import { Base } from "base";
@@ -5826,6 +5900,7 @@ declare module "survey-events-api" {
     import { QuestionPanelDynamicModel } from "question_paneldynamic";
     import { SurveyModel } from "survey";
     import { SurveyError } from "survey-error";
+    import { ITheme } from "themes";
     import { Trigger } from "trigger";
     export interface QuestionEventMixin {
         /**
@@ -6773,6 +6848,9 @@ declare module "survey-events-api" {
          */
         visible: boolean;
     }
+    export interface ThemeAppliedEvent {
+        theme: ITheme;
+    }
 }
 declare module "drag-drop-page-helper-v1" {
     import { IElement, ISurveyElement } from "base-interfaces";
@@ -7118,6 +7196,7 @@ declare module "notifier" {
         timer: any;
         private actionsVisibility;
         actionBar: ActionContainer;
+        showActions: boolean;
         constructor(cssClasses: {
             root: string;
             info: string;
@@ -7590,25 +7669,6 @@ declare module "question_multipletext" {
         protected getClassName(): string;
     }
 }
-declare module "themes" {
-    export type ImageFit = "auto" | "contain" | "cover";
-    export type ImageAttachment = "fixed" | "scroll";
-    export interface ITheme {
-        themeName?: string;
-        colorPalette?: string;
-        isPanelless?: boolean;
-        backgroundImage?: string;
-        backgroundImageFit?: ImageFit;
-        backgroundImageAttachment?: ImageAttachment;
-        backgroundOpacity?: number;
-        cover?: {
-            [index: string]: any;
-        };
-        cssVariables?: {
-            [index: string]: string;
-        };
-    }
-}
 declare module "cover" {
     import { Base } from "base";
     import { HorizontalAlignment, VerticalAlignment } from "base-interfaces";
@@ -7632,21 +7692,23 @@ declare module "cover" {
         get showLogo(): boolean;
         get showTitle(): boolean;
         get showDescription(): boolean;
-        get textWidth(): string;
+        get textAreaWidth(): string;
     }
     export class Cover extends Base {
+        private _survey;
         private calcBackgroundSize;
+        private updateCoverClasses;
+        private updateContentClasses;
+        private updateBackgroundImageClasses;
         fromTheme(theme: ITheme): void;
         constructor();
         getType(): string;
-        survey: SurveyModel;
         cells: CoverCell[];
         height: number;
-        areaWidth: "survey" | "container";
-        textWidth: number;
-        invertText: boolean;
-        glowText: boolean;
-        overlap: boolean;
+        inheritWidthFrom: "survey" | "page";
+        textAreaWidth: number;
+        textGlowEnabled: boolean;
+        overlapEnabled: boolean;
         backgroundColor: string;
         backgroundImage: string;
         renderBackgroundImage: string;
@@ -7670,16 +7732,19 @@ declare module "cover" {
             gridColumn: number;
             gridRow: number;
         };
+        coverClasses: string;
+        contentClasses: string;
+        backgroundImageClasses: string;
         get renderedHeight(): string;
-        get renderedTextWidth(): string;
-        get coverClasses(): string;
-        get contentClasses(): string;
-        get backgroundImageClasses(): string;
+        get renderedtextAreaWidth(): string;
+        get survey(): SurveyModel;
+        set survey(newValue: SurveyModel);
         get backgroundImageStyle(): {
             opacity: number;
             backgroundImage: string;
             backgroundSize: string;
         };
+        protected propertyValueChanged(name: string, oldValue: any, newValue: any): void;
     }
 }
 declare module "survey" {
@@ -7703,7 +7768,7 @@ declare module "survey" {
     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, IsAnswerCorrectEvent, DragDropAllowEvent, ScrollingElementToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, ElementContentVisibilityChangedEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent, ThemeAppliedEvent } from "survey-events-api";
     import { QuestionMatrixDropdownModelBase } from "question_matrixdropdownbase";
     import { QuestionMatrixDynamicModel } from "question_matrixdynamic";
     import { QuestionFileModel } from "question_file";
@@ -7746,7 +7811,11 @@ declare module "survey" {
         private timerModelValue;
         private navigationBarValue;
         onThemeApplying: EventBase<SurveyModel>;
-        onThemeApplied: EventBase<SurveyModel>;
+        /**
+         * An event that is raised after a [theme](/form-library/documentation/manage-default-themes-and-styles) is [applied](#applyTheme) to the survey.
+         * @see applyTheme
+         */
+        onThemeApplied: EventBase<SurveyModel, ThemeAppliedEvent>;
         /**
          * An event that is raised after a [trigger](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#triggers) is executed.
          *
@@ -8336,10 +8405,12 @@ declare module "survey" {
          * For information on event handler parameters, refer to descriptions within the interface.
          *
          * [View Demo](https://surveyjs.io/form-library/examples/survey-titleactions/ (linkStyle))
+         * @see [IAction](https://surveyjs.io/form-library/documentation/api-reference/iaction)
         */
         onGetQuestionTitleActions: EventBase<SurveyModel, GetQuestionTitleActionsEvent>;
         /**
          * An event that allows you to add, delete, or modify actions in a panel title.
+         * @see [IAction](https://surveyjs.io/form-library/documentation/api-reference/iaction)
          */
         onGetPanelTitleActions: EventBase<SurveyModel, GetPanelTitleActionsEvent>;
         /**
@@ -8348,10 +8419,12 @@ declare module "survey" {
          * For information on event handler parameters, refer to descriptions within the interface.
          *
          * [View Demo](https://surveyjs.io/form-library/examples/modify-titles-of-survey-elements/ (linkStyle))
+         * @see [IAction](https://surveyjs.io/form-library/documentation/api-reference/iaction)
          */
         onGetPageTitleActions: EventBase<SurveyModel, GetPageTitleActionsEvent>;
         /**
          * An event that allows you to add, delete, or modify actions in the footer of a [Panel](https://surveyjs.io/form-library/documentation/panelmodel).
+         * @see [IAction](https://surveyjs.io/form-library/documentation/api-reference/iaction)
          */
         onGetPanelFooterActions: EventBase<SurveyModel, GetPanelFooterActionsEvent>;
         /**
@@ -8360,7 +8433,7 @@ declare module "survey" {
          * For information on event handler parameters, refer to descriptions within the interface.
          *
          * [View Demo](https://surveyjs.io/form-library/examples/employee-information-form/ (linkStyle))
-         * @see IAction
+         * @see [IAction](https://surveyjs.io/form-library/documentation/api-reference/iaction)
          */
         onGetMatrixRowActions: EventBase<SurveyModel, GetMatrixRowActionsEvent>;
         /**
@@ -8423,7 +8496,7 @@ declare module "survey" {
         loadingBodyCss: string;
         containerCss: string;
         fitToContainer: boolean;
-        titleView: "cover" | "title";
+        headerView: "advanced" | "basic";
         private getNavigationCss;
         private lazyRenderingValue;
         showBrandInfo: boolean;
@@ -9349,7 +9422,7 @@ declare module "survey" {
         get completedState(): string;
         get completedStateText(): string;
         protected setCompletedState(value: string, text: string): void;
-        notify(message: string, type: string): void;
+        notify(message: string, type: string, showActions?: boolean): void;
         /**
          * Resets the survey [`state`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#state) and, optionally, [`data`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#data). If `state` is `"completed"`, it becomes `"running"`.
          * @param clearData *(Optional)* Specifies whether to clear survey data. Default value: `true`.
@@ -10363,6 +10436,13 @@ declare module "survey" {
         removeLayoutElement(layoutElementId: string): ISurveyLayoutElement;
         getContainerContent(container: LayoutElementContainer): any[];
         processPopupVisiblityChanged(question: Question, popup: PopupModel<any>, visible: boolean): void;
+        /**
+         * Applies a specified theme to the survey.
+         *
+         * [Themes & Styles](/form-library/documentation/manage-default-themes-and-styles (linkStyle))
+         * @param theme An [`ITheme`](/form-library/documentation/api-reference/itheme) object with theme settings.
+         * @see onThemeApplied
+         */
         applyTheme(theme: ITheme): void;
         /**
          * Disposes of the survey model.
@@ -10763,7 +10843,6 @@ declare module "survey-element" {
         get paddingRight(): string;
         set paddingRight(val: string);
         allowRootStyle: boolean;
-        renderMinWidth: boolean;
         get rootStyle(): {
             [index: string]: any;
         };
@@ -11050,8 +11129,11 @@ declare module "question" {
         get isQuestion(): boolean;
         moveTo(container: IPanel, insertBefore?: any): boolean;
         getProgressInfo(): IProgressInfo;
-        private resetValueIfExpression;
-        private isRunningResetValueIf;
+        private setValueExpressionRunner;
+        private runSetValueExpression;
+        private triggersInfo;
+        private addTriggerInfo;
+        private runTriggerInfo;
         runTriggers(name: string, value: any): void;
         private runConditions;
         setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
@@ -11447,6 +11529,7 @@ declare module "question" {
          *
          * An expression can also include built-in and custom functions for advanced calculations. For example, if the `defaultValue` should be today's date, set the `defaultValueExpression` to `"today()"`, and the corresponding built-in function will be executed each time the survey is loaded. Refer to the following help topic for more information: [Built-In Functions](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#built-in-functions).
          * @see defaultValue
+         * @see setValueExpression
          */
         get defaultValueExpression(): any;
         set defaultValueExpression(val: any);
@@ -11456,9 +11539,29 @@ declare module "question" {
          * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
          *
          * [Expressions](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions (linkStyle))
+         * @see setValueIf
          */
         get resetValueIf(): string;
         set resetValueIf(val: string);
+        /**
+         * A Boolean expression. If it evaluates to `true`, the question value is set to a value calculated using the [`setValueExpression`](#setValueExpression).
+         *
+         * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
+         *
+         * [Expressions](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions (linkStyle))
+         * @see resetValueIf
+         */
+        get setValueIf(): string;
+        set setValueIf(val: string);
+        /**
+         * An expression used to calculate the question value. Applies only when the [`setValueIf`](#setValueIf) expression evaluates to `true`.
+         *
+         * [Expressions](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions (linkStyle))
+         * @see defaultValueExpression
+         * @see resetValueIf
+         */
+        get setValueExpression(): string;
+        set setValueExpression(val: string);
         get resizeStyle(): "none" | "both";
         /**
          * Returns the question value as an object in which the question name, title, value, and other parameters are stored as individual properties.