survey-core 1.9.111 → 1.9.113

package/typings/question_multipletext.d.ts

@@ -90,6 +90,16 @@ export declare class MultipleTextItemModel extends Base implements IValidatorOwn
      */
     get size(): number;
     set size(val: number);
+    /**
+     * The minimum value specified as an expression. For example, `"minValueExpression": "today(-1)"` sets the minimum value to yesterday.
+     */
+    get minValueExpression(): string;
+    set minValueExpression(val: string);
+    /**
+     * The maximum value specified as an expression. For example, `"maxValueExpression": "today(1)"` sets the maximum value to tomorrow.
+     */
+    get maxValueExpression(): string;
+    set maxValueExpression(val: string);
     /**
      * The list of question validators.
      */

package/typings/question_paneldynamic.d.ts

@@ -7,6 +7,7 @@ import { SurveyError } from "./survey-error";
 import { ActionContainer } from "./actions/container";
 import { IAction } from "./actions/action";
 import { AdaptiveActionContainer } from "./actions/adaptive-container";
+import { ITheme } from "./themes";
 export interface IQuestionPanelDynamicData {
     getItemIndex(item: ISurveyData): number;
     getVisibleItemIndex(item: ISurveyData): number;
@@ -283,6 +284,7 @@ export declare class QuestionPanelDynamicModel extends Question implements IQues
     protected getValueCore(): any;
     protected setValueCore(newValue: any): void;
     setIsMobile(val: boolean): void;
+    themeChanged(theme: ITheme): void;
     /**
      * The number of panels in Dynamic Panel.
      * @see minPanelCount

package/typings/question_ranking.d.ts

@@ -50,8 +50,7 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
     protected supportSelectAll(): boolean;
     supportOther(): boolean;
     supportNone(): boolean;
-    private handleArrowUp;
-    private handleArrowDown;
+    private handleArrowKeys;
     handleKeydownSelectToRank(event: KeyboardEvent, movedElement: ItemValue): void;
     private setValueAfterKeydown;
     private focusItem;

package/typings/question_rating.d.ts

@@ -4,6 +4,7 @@ import { LocalizableString } from "./localizablestring";
 import { Base } from "./base";
 import { DropdownListModel } from "./dropdownListModel";
 import { ISurveyImpl } from "./base-interfaces";
+import { ITheme } from "./themes";
 export declare class RenderedRatingItem extends Base {
     itemValue: ItemValue;
     private locString;
@@ -215,7 +216,12 @@ export declare class QuestionRatingModel extends Question {
     rateColorMode: "default" | "scale";
     get isStar(): boolean;
     get isSmiley(): boolean;
-    get itemComponentName(): "sv-rating-item-star" | "sv-rating-item-smiley" | "sv-rating-item";
+    getDefaultItemComponent(): string;
+    /**
+     * The name of a component used to render items.
+     */
+    get itemComponent(): string;
+    set itemComponent(value: string);
     protected valueToData(val: any): any;
     setValueFromClick(value: any): void;
     onItemMouseIn(item: RenderedRatingItem): void;
@@ -255,6 +261,7 @@ export declare class QuestionRatingModel extends Question {
     get dropdownListModel(): DropdownListModel;
     protected updateCssClasses(res: any, css: any): void;
     protected calcCssClasses(css: any): any;
+    themeChanged(theme: ITheme): void;
     setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
     dispose(): void;
 }

package/typings/question_signaturepad.d.ts

@@ -1,5 +1,5 @@
 import { Question } from "./question";
-import { ISurveyImpl } from "./base-interfaces";
+import { ITheme } from "./themes";
 /**
  * A class that describes the Signature question type.
  *
@@ -15,7 +15,7 @@ export declare class QuestionSignaturePadModel extends Question {
     getType(): string;
     afterRenderQuestionElement(el: HTMLElement): void;
     beforeDestroyQuestionElement(el: HTMLElement): void;
-    setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
+    themeChanged(theme: ITheme): void;
     initSignaturePad(el: HTMLElement): void;
     destroySignaturePad(el: HTMLElement): void;
     /**

package/typings/question_tagbox.d.ts

@@ -72,5 +72,6 @@ export declare class QuestionTagboxModel extends QuestionCheckboxModel {
     getInputId(): string;
     dispose(): void;
     clearValue(): void;
+    get showClearButton(): boolean;
     get isNewA11yStructure(): boolean;
 }

package/typings/question_text.d.ts

@@ -126,3 +126,4 @@ export declare class QuestionTextModel extends QuestionTextBase {
     onBlur: (event: any) => void;
     onFocus: (event: any) => void;
 }
+export declare function isMinMaxType(obj: any): boolean;

package/typings/settings.d.ts

@@ -464,6 +464,12 @@ export declare var settings: {
     notifications: {
         lifetime: number;
     };
+    /**
+     * Specifies how many milliseconds a survey should wait before it automatically switches to the next page. Applies only when [auto-advance](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#goNextPageAutomatic) is enabled.
+     *
+     * Default value: 300
+     */
+    autoAdvanceDelay: number;
     /**
      * Specifies the direction in which to lay out Checkbox and Radiogroup items. This setting affects the resulting UI when items are arranged in [more than one column](https://surveyjs.io/form-library/documentation/api-reference/checkbox-question-model#colCount).
      *

package/typings/survey-element.d.ts

@@ -383,7 +383,6 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
     get paddingRight(): string;
     set paddingRight(val: string);
     allowRootStyle: boolean;
-    renderMinWidth: boolean;
     get rootStyle(): {
         [index: string]: any;
     };

package/typings/survey.d.ts

@@ -60,8 +60,6 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private editingObjValue;
     private timerModelValue;
     private navigationBarValue;
-    onThemeApplying: EventBase<SurveyModel>;
-    onThemeApplied: EventBase<SurveyModel>;
     /**
      * An event that is raised after a [trigger](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#triggers) is executed.
      *
@@ -651,10 +649,12 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * 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>;
     /**
@@ -663,10 +663,12 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * 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>;
     /**
@@ -675,7 +677,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * 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>;
     /**
@@ -738,7 +740,18 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     loadingBodyCss: string;
     containerCss: string;
     fitToContainer: boolean;
-    titleView: "cover" | "title";
+    /**
+     * 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.
+     */
+    headerView: "advanced" | "basic";
     private getNavigationCss;
     private lazyRenderingValue;
     showBrandInfo: boolean;
@@ -985,6 +998,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * > If any of the following questions is answered last, the survey does not switch to the next page: Checkboxes, Yes/No (Boolean) (rendered as Checkbox), Long Text, Signature, Image Picker (with Multi Select), File Upload, Single-Select Matrix (not all rows are answered), Dynamic Matrix, Dynamic Panel.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/automatically-move-to-next-page-if-answer-selected/ (linkStyle))
+     * @see [`settings.autoAdvanceDelay`](https://surveyjs.io/form-library/documentation/api-reference/settings#autoAdvanceDelay)
      */
     get goNextPageAutomatic(): boolean | "autogonext";
     set goNextPageAutomatic(val: boolean | "autogonext");
@@ -992,6 +1006,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * Specifies whether to complete the survey automatically after a user answers all questions on the last page. Applies only if the [`goNextPageAutomatic`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#goNextPageAutomatic) property is `true`.
      *
      * Default value: `true`
+     * @see [`settings.autoAdvanceDelay`](https://surveyjs.io/form-library/documentation/api-reference/settings#autoAdvanceDelay)
      */
     get allowCompleteSurveyAutomatic(): boolean;
     set allowCompleteSurveyAutomatic(val: boolean);
@@ -1664,7 +1679,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     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`.
@@ -2678,7 +2693,14 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     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.
+     */
     applyTheme(theme: ITheme): void;
+    themeChanged(theme: ITheme): void;
     /**
      * Disposes of the survey model.
      *

package/typings/surveytimer.d.ts

@@ -2,6 +2,7 @@ import { Event } from "./base";
 export declare var surveyTimerFunctions: {
     setTimeout: (func: () => any) => number;
     clearTimeout: (timerId: number) => void;
+    safeTimeOut: (func: () => any, delay: number) => number;
 };
 export declare class SurveyTimer {
     private static instanceValue;

package/typings/themes.d.ts

@@ -1,17 +1,202 @@
+import { HorizontalAlignment, VerticalAlignment } from "./base-interfaces";
 export declare type ImageFit = "auto" | "contain" | "cover";
 export declare 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;
-    cover?: {
-        [index: string]: any;
-    };
+    /**
+     * 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"`.
+     */
+    header?: IHeader;
+    /**
+     * An object with CSS variables.
+     */
     cssVariables?: {
         [index: string]: string;
     };
 }
+/**
+ * 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"`.
+ */
+export interface IHeader {
+    /**
+     * The height of the survey header in pixels.
+     *
+     * Default value: 256
+     */
+    height: number;
+    /**
+     * A string value that specifies whether the header spans the width of the survey or that of the survey container.
+     *
+     * Possible values:
+     *
+     * - `"survey"` (default)\
+     * The header width is the same as the survey width.
+     * - `"container"`\
+     * The header width is the same as the survey container width.
+     *
+     * @see [SurveyModel.width](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#width)
+     * @see [SurveyModel.widthMode](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#widthMode)
+     */
+    inheritWidthFrom: "survey" | "container";
+    /**
+     * The width of the header area that contains the survey [title](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#title) and [description](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#description), measured in pixels.
+     *
+     * Default value: 512
+     */
+    textAreaWidth: number;
+    /**
+     * A Boolean value that specifies whether the header overlaps the survey content.
+     *
+     * Default value: `false`
+     */
+    overlapEnabled: boolean;
+    /**
+     * An image to display in the background of the header. Accepts a base64 or URL string value.
+     */
+    backgroundImage: string;
+    /**
+     * 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.
+     */
+    backgroundImageOpacity: number;
+    /**
+     * A string value that specifies how to resize a [background image](#backgroundImage) to fit it into the header.
+     *
+     * Possible values:
+     *
+     * - `"cover"` (default)\
+     * Scales the image to the smallest possible size that fills the header. The image preserves its aspect ratio but can be cropped if the header's proportions differ from that of the element.
+     * - `"fill"`\
+     * Stretches the image to fill the entire header.
+     * - `"contain"`\
+     * Scales the image to the largest possible size without cropping or stretching it.
+     * - `"tile"`\
+     * Tiles as many copies of the image as needed to fill the entire header.
+     */
+    backgroundImageFit: "cover" | "fill" | "contain" | "tile";
+    /**
+     * A string value that specifies the logo position within the header in the horizontal direction.
+     *
+     * Possible values:
+     *
+     * - `"right"` (default)
+     * - `"left"`
+     * - `"center"`
+     *
+     * To specify a logo, set `SurveyModel`'s [`logo`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#logo) property.
+     */
+    logoPositionX: HorizontalAlignment;
+    /**
+     * A string value that specifies the logo position within the header in the vertical direction.
+     *
+     * Possible values:
+     *
+     * - `"top"` (default)
+     * - `"bottom"`
+     * - `"middle"`
+     *
+     * To specify a logo, set `SurveyModel`'s [`logo`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#logo) property.
+     */
+    logoPositionY: VerticalAlignment;
+    /**
+     * A string value that specifies the survey title position within the header in the horizontal direction.
+     *
+     * Possible values:
+     *
+     * - `"left"` (default)
+     * - `"right"`
+     * - `"center"`
+     *
+     * To specify a survey title, set `SurveyModel`'s [`title`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#title) property.
+     */
+    titlePositionX: HorizontalAlignment;
+    /**
+     * A string value that specifies the survey title position within the header in the vertical direction.
+     *
+     * Possible values:
+     *
+     * - `"bottom"` (default)
+     * - `"top"`
+     * - `"middle"`
+     *
+     * To specify a survey title, set `SurveyModel`'s [`title`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#title) property.
+     */
+    titlePositionY: VerticalAlignment;
+    /**
+     * A string value that specifies the survey description position within the header in the horizontal direction.
+     *
+     * Possible values:
+     *
+     * - `"left"` (default)
+     * - `"right"`
+     * - `"center"`
+     *
+     * To specify a survey description, set `SurveyModel`'s [`description`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#description) property.
+     */
+    descriptionPositionX: HorizontalAlignment;
+    /**
+     * A string value that specifies the survey description position within the header in the vertical direction.
+     *
+     * Possible values:
+     *
+     * - `"bottom"` (default)
+     * - `"top"`
+     * - `"middle"`
+     *
+     * To specify a survey description, set `SurveyModel`'s [`description`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#description) property.
+     */
+    descriptionPositionY: VerticalAlignment;
+}