survey-core 1.9.136 → 1.9.138

package/themes/solid-light.min.js

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

package/themes/three-dimensional-dark-panelless.js

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

package/themes/three-dimensional-dark-panelless.min.js

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

package/themes/three-dimensional-dark.js

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

package/themes/three-dimensional-dark.min.js

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

package/themes/three-dimensional-light-panelless.js

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

package/themes/three-dimensional-light-panelless.min.js

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

package/themes/three-dimensional-light.js

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

package/themes/three-dimensional-light.min.js

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

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

@@ -292,12 +292,12 @@ export declare class Base {
     private getValueInLowCase;
     getElementsInDesign(includeHidden?: boolean): Array<IElement>;
 }
-export declare class ArrayChanges {
+export declare class ArrayChanges<T = any> {
     index: number;
     deleteCount: number;
-    itemsToAdd: any[];
-    deletedItems: any[];
-    constructor(index: number, deleteCount: number, itemsToAdd: any[], deletedItems: any[]);
+    itemsToAdd: T[];
+    deletedItems: T[];
+    constructor(index: number, deleteCount: number, itemsToAdd: T[], deletedItems: T[]);
 }
 export declare class Event<CallbackFunction extends Function, Sender, Options> {
     onCallbacksChanged: () => void;

package/ts3.4/typings/defaultCss/defaultV2Css.d.ts

@@ -45,6 +45,10 @@ export declare var defaultV2Css: {
         edit: string;
     };
     panel: {
+        contentFadeIn: string;
+        contentFadeOut: string;
+        fadeIn: string;
+        fadeOut: string;
         asPage: string;
         number: string;
         title: string;
@@ -67,6 +71,8 @@ export declare var defaultV2Css: {
         header: string;
         collapsed: string;
         expanded: string;
+        expandable: string;
+        expandableAnimating: string;
         nested: string;
         invisible: string;
         navigationButton: string;
@@ -154,8 +160,14 @@ export declare var defaultV2Css: {
     row: string;
     rowMultiple: string;
     rowCompact: string;
+    rowFadeIn: string;
+    rowFadeOut: string;
     pageRow: string;
     question: {
+        contentFadeIn: string;
+        contentFadeOut: string;
+        fadeIn: string;
+        fadeOut: string;
         mainRoot: string;
         flowRoot: string;
         withFrame: string;
@@ -198,6 +210,8 @@ export declare var defaultV2Css: {
         hasErrorTop: string;
         hasErrorBottom: string;
         collapsed: string;
+        expandable: string;
+        expandableAnimating: string;
         expanded: string;
         nested: string;
         invisible: string;

package/ts3.4/typings/dragdrop/matrix-rows.d.ts

@@ -1,5 +1,5 @@
 import { MatrixDropdownRowModelBase } from "../question_matrixdropdownbase";
-import { QuestionMatrixDynamicModel } from "../question_matrixdynamic";
+import { QuestionMatrixDynamicModel, MatrixDynamicRowModel } from "../question_matrixdynamic";
 import { DragDropCore } from "./core";
 export declare class DragDropMatrixRows extends DragDropCore<QuestionMatrixDynamicModel> {
     protected readonly draggedElementType: string;
@@ -9,6 +9,7 @@ export declare class DragDropMatrixRows extends DragDropCore<QuestionMatrixDynam
     private fromIndex;
     private toIndex;
     protected getDropTargetByDataAttributeValue(dataAttributeValue: any): MatrixDropdownRowModelBase;
+    canInsertIntoThisRow(row: MatrixDynamicRowModel): boolean;
     protected isDropTargetValid(dropTarget: any, dropTargetNode?: HTMLElement): boolean;
     protected calculateIsBottom(clientY: number): boolean;
     protected afterDragOver(dropTargetNode: HTMLElement): void;

package/ts3.4/typings/dragdrop/ranking-choices.d.ts

@@ -15,6 +15,6 @@ export declare class DragDropRankingChoices extends DragDropChoices {
     protected updateDraggedElementShortcut(newIndex: number): void;
     protected ghostPositionChanged(): void;
     protected doBanDropHere: () => any;
-    protected doDrop: () => any;
+    protected doDrop(): any;
     clear(): void;
 }

package/ts3.4/typings/dragdrop/ranking-select-to-rank.d.ts

@@ -12,12 +12,15 @@ export declare class DragDropRankingSelectToRank extends DragDropRankingChoices
         fromIndex: number;
         toIndex: number;
     };
+    protected calculateIsBottom(clientY: number, dropTargetNode?: HTMLElement): boolean;
     private doUIEffects;
     private readonly isDraggedElementRanked: any;
     private readonly isDropTargetRanked: any;
     private readonly isDraggedElementUnranked: any;
     private readonly isDropTargetUnranked: any;
-    selectToRank(questionModel: QuestionRankingModel, fromIndex: number, toIndex: number): void;
-    unselectFromRank(questionModel: QuestionRankingModel, fromIndex: number, toIndex?: number): void;
-    reorderRankedItem(questionModel: QuestionRankingModel, fromIndex: number, toIndex: number): void;
+    private updateChoices;
+    selectToRank: (questionModel: QuestionRankingModel, fromIndex: number, toIndex: number) => void;
+    unselectFromRank: (questionModel: QuestionRankingModel, fromIndex: number, toIndex?: number) => void;
+    reorderRankedItem: (questionModel: QuestionRankingModel, fromIndex: number, toIndex: number, dropTargetNode?: HTMLElement) => void;
+    clear(): void;
 }

package/ts3.4/typings/entries/core-wo-model.d.ts

@@ -6,6 +6,7 @@ export * from "../rendererFactory";
 export * from "../utils/responsivity-manager";
 export { unwrap, getOriginalEvent, getElement } from "../utils/utils";
 export * from "../actions/action";
+export * from "../utils/animation";
 export * from "../actions/adaptive-container";
 export * from "../actions/container";
 export * from "../utils/dragOrClickHelper";

package/ts3.4/typings/mask/input_element_adapter.d.ts

@@ -6,6 +6,7 @@ export declare class InputElementAdapter {
     private prevUnmaskedValue;
     constructor(inputMaskInstance: InputMaskBase, inputElement: HTMLInputElement, value?: string);
     inputMaskInstancePropertyChangedHandler: (sender: any, options: any) => void;
+    clickHandler: (event: any) => void;
     beforeInputHandler: (event: any) => void;
     createArgs(event: any): ITextInputParams;
     addInputEventListener(): void;

package/ts3.4/typings/mask/mask_datetime.d.ts

@@ -6,6 +6,16 @@ export interface IDateTimeMaskLexem {
     count: number;
     maxCount: number;
 }
+interface IDateTimeComposition {
+    day: number;
+    month: number;
+    year: number;
+    hour?: number;
+    minute?: number;
+    second?: number;
+    min?: Date;
+    max?: Date;
+}
 export declare function getDateTimeLexems(pattern: string): Array<IDateTimeMaskLexem>;
 /**
  * A class that describes an input mask of the `"datetime"` [`maskType`](https://surveyjs.io/form-library/documentation/api-reference/text-entry-question-model#maskType).
@@ -46,7 +56,7 @@ export declare class InputMaskDateTime extends InputMaskPattern {
     private leaveOnlyNumbers;
     private getMaskedStrFromISO;
     private initInputDateTimeData;
-    private getISO_8601Format;
+    getISO_8601Format(dateTime: IDateTimeComposition): string;
     private isYearValid;
     private isDateValid;
     private getPlaceholder;
@@ -57,9 +67,9 @@ export declare class InputMaskDateTime extends InputMaskPattern {
     private getFormatedString;
     private setInputDateTimeData;
     _getMaskedValue(src: string, matchWholeMask?: boolean): string;
-    private getPartsOld;
     private getParts;
     getUnmaskedValue(src: string): any;
     getMaskedValue(src: string): string;
     processInput(args: ITextInputParams): IMaskedInputResult;
 }
+export {};

package/ts3.4/typings/mask/mask_numeric.d.ts

@@ -75,7 +75,7 @@ export declare class InputMaskNumeric extends InputMaskBase {
     private calccaretPosition;
     displayNumber(parsedNumber: INumericalComposition, insertThousandsSeparator?: boolean, matchWholeMask?: boolean): string;
     convertNumber(parsedNumber: INumericalComposition): number;
-    validateNumber(number: INumericalComposition): boolean;
+    validateNumber(number: INumericalComposition, matchWholeMask: boolean): boolean;
     parseNumber(src: string | number): INumericalComposition;
     getNumberMaskedValue(src: string | number, matchWholeMask?: boolean): string;
     private getNumberUnmaskedValue;

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

@@ -9,6 +9,7 @@ import { SurveyError } from "./survey-error";
 import { IAction } from "./actions/action";
 import { ActionContainer } from "./actions/container";
 import { DragDropInfo } from "./drag-drop-helper-v1";
+import { AnimationGroup } from "./utils/animation";
 export declare class QuestionRowModel extends Base {
     panel: PanelModelBase;
     private static rowCounter;
@@ -24,8 +25,12 @@ export declare class QuestionRowModel extends Base {
     setIsLazyRendering(val: boolean): void;
     isLazyRendering(): boolean;
     readonly id: string;
+    protected equalsCore(obj: Base): boolean;
     readonly elements: Array<IElement>;
-    readonly visibleElements: Array<IElement>;
+    private getVisibleElementsAnimationOptions;
+    visibleElementsAnimation: AnimationGroup<IElement>;
+    visibleElements: Array<IElement>;
+    onVisibleChangedCallback: () => void;
     visible: boolean;
     isNeedRender: boolean;
     updateVisible(): void;
@@ -35,11 +40,12 @@ export declare class QuestionRowModel extends Base {
     private getRenderedCalcWidth;
     private getElementWidth;
     private getRenderedWidthFromWidth;
-    private calcVisible;
-    private needToUpdateVisibleElements;
     dragTypeOverMe: DragTypeOverMeEnum;
     dispose(): void;
     getRowCss(): string;
+    private rootElement?;
+    setRootElement(element?: HTMLElement): void;
+    getRootElement(): HTMLElement;
 }
 /**
  * A base class for the [PanelModel](https://surveyjs.io/form-library/documentation/panelmodel) and [PageModel](https://surveyjs.io/form-library/documentation/pagemodel) classes.
@@ -54,6 +60,12 @@ export declare class PanelModelBase extends SurveyElement<Question> implements I
     removeElementCallback: (element: IElement) => void;
     onGetQuestionTitleLocation: () => string;
     private dragDropPanelHelper;
+    onAddRow(row: QuestionRowModel): void;
+    private getRowsAnimationOptions;
+    private rowsAnimation;
+    visibleRows: Array<QuestionRowModel>;
+    onRemoveRow(row: QuestionRowModel): void;
+    onRowVisibleChanged(): void;
     constructor(name?: string);
     getType(): string;
     setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
@@ -316,7 +328,8 @@ export declare class PanelModelBase extends SurveyElement<Question> implements I
     * @see visible
     */
     readonly isVisible: boolean;
-    getIsPageVisible(exceptionQuestion: IQuestion): boolean;
+    getIsContentVisible(exceptionQuestion?: IQuestion): boolean;
+    getIsPageVisible(exceptionQuestion?: IQuestion): boolean;
     private lastVisibleIndex;
     setVisibleIndex(index: number): number;
     private updateVisibleIndexes;

package/ts3.4/typings/popup-view-model.d.ts

@@ -1,11 +1,10 @@
-import { Base } from "./base";
+import { Base, EventBase } from "./base";
 import { PopupModel } from "./popup";
 import { CssClassBuilder } from "./utils/cssClassBuilder";
 import { ActionContainer } from "./actions/container";
+import { AnimationOptions, IAnimationConsumer } from "./utils/animation";
 export declare const FOCUS_INPUT_SELECTOR = "input:not(:disabled):not([readonly]):not([type=hidden]),select:not(:disabled):not([readonly]),textarea:not(:disabled):not([readonly]), button:not(:disabled):not([readonly]), [tabindex]:not([tabindex^=\"-\"])";
-export declare class PopupBaseViewModel extends Base {
-    private static SubscriptionId;
-    private subscriptionId;
+export declare class PopupBaseViewModel extends Base implements IAnimationConsumer {
     protected popupSelector: string;
     protected fixedPopupContainer: string;
     protected containerSelector: string;
@@ -17,8 +16,17 @@ export declare class PopupBaseViewModel extends Base {
     height: string;
     width: string;
     minWidth: string;
-    isVisible: boolean;
+    _isVisible: boolean;
     locale: string;
+    private updateIsVisible;
+    private visibilityAnimation;
+    getLeaveOptions(): AnimationOptions;
+    getEnterOptions(): AnimationOptions;
+    getAnimatedElement(): HTMLElement;
+    isAnimationEnabled(): boolean;
+    private getAnimationContainer;
+    isVisible: boolean;
+    onVisibilityChanged: EventBase<PopupBaseViewModel, any>;
     readonly container: HTMLElement;
     private containerElement;
     private createdContainer;
@@ -31,6 +39,7 @@ export declare class PopupBaseViewModel extends Base {
     protected createFooterActionBar(): void;
     protected resetDimensionsAndPositionStyleProperties(): void;
     protected onModelChanging(newModel: PopupModel): void;
+    private onModelIsVisibleChangedCallback;
     private setupModel;
     private _model;
     model: PopupModel;

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

@@ -6,6 +6,7 @@ import { SurveyElement } from "./survey-element";
 import { PanelModel } from "./panel";
 import { HashTable } from "./helpers";
 import { ItemValue } from "./itemvalue";
+import { SurveyError } from "./survey-error";
 /**
  * An interface used to create custom question types.
  *
@@ -224,6 +225,13 @@ export interface ICustomQuestionTypeConfiguration {
      * @see questionJSON
      */
     createQuestion?: any;
+    /**
+     * A function that allows you to display different error texts based on conditions.
+     * @param question A custom question. Use the `question.value` property to access the question's value.
+     * @returns An error text.
+     */
+    getErrorText?: (question: Question) => string;
+    onSetQuestionValue?: (question: Question, newValue: any) => void;
     valueToQuestion?: (val: any) => any;
     valueFromQuestion?: (val: any) => any;
     getValue?: (val: any) => any;
@@ -240,9 +248,11 @@ export declare class ComponentQuestionJSON {
     onAfterRender(question: Question, htmlElement: any): void;
     onAfterRenderContentElement(question: Question, element: Question, htmlElement: any): void;
     onUpdateQuestionCssClasses(question: Question, element: Question, css: any): void;
+    onSetQuestionValue(question: Question, newValue: any): void;
     onPropertyChanged(question: Question, propertyName: string, newValue: any): void;
     onValueChanged(question: Question, name: string, newValue: any): void;
     onValueChanging(question: Question, name: string, newValue: any): any;
+    onGetErrorText(question: Question): string;
     onItemValuePropertyChanged(question: Question, item: ItemValue, propertyName: string, name: string, newValue: any): void;
     getDisplayValue(keyAsText: boolean, value: any, question: Question): any;
     readonly defaultQuestionTitle: any;
@@ -295,6 +305,7 @@ export declare abstract class QuestionCustomModelBase extends Question implement
     protected onUpdateQuestionCssClasses(element: Question, css: any): void;
     protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
     protected setNewValue(newValue: any): void;
+    protected onCheckForErrors(errors: Array<SurveyError>, isOnValueChanged: boolean): void;
     getSurveyData(): ISurveyData;
     getTextProcessor(): ITextProcessor;
     getValue(name: string): any;

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

@@ -61,11 +61,12 @@ export declare class QuestionImagePickerModel extends QuestionCheckboxBase {
     /*
     * Specifies the height of containers for images or videos. Accepts positive numbers and CSS values.
     *
-    * Default value: undefined
+    * Default value: `auto`
     *
-    * Use the `imageFit` property to specify how to fit the images or videos into their containers.
+    * This property allows you to specify the exact image height. If you do not set it, the height will be calculated automatically based on the [`minImageHeight`](#minImageHeight) and [`maxImageHeight`](#maxImageHeight) values and available screen height.
+    *
+    * Use the [`imageFit`](#imageFit) property to specify how to fit the images or videos into their containers.
     * @see imageWidth
-    * @see imageFit
     */
     imageHeight: number;
     private responsiveImageHeight;
@@ -73,11 +74,12 @@ export declare class QuestionImagePickerModel extends QuestionCheckboxBase {
     /*
     * Specifies the width of containers for images or videos. Accepts positive numbers and CSS values.
     *
-    * Default value: 200
+    * Default value: `auto`
+    *
+    * This property allows you to specify the exact image width. If you do not set it, the width will be calculated automatically based on the [`minImageWidth`](#minImageWidth) and [`maxImageWidth`](#maxImageWidth) values and available screen width.
     *
-    * Use the `imageFit` property to specify how to fit the images or videos into their containers.
+    * Use the [`imageFit`](#imageFit) property to specify how to fit the images or videos into their containers.
     * @see imageHeight
-    * @see imageFit
     */
     imageWidth: number;
     private responsiveImageWidth;
@@ -105,9 +107,37 @@ export declare class QuestionImagePickerModel extends QuestionCheckboxBase {
     protected addToVisibleChoices(items: Array<ItemValue>, isAddAll: boolean): void;
     getSelectBaseRootCss(): string;
     private isResponsiveValue;
+    /**
+     * Specifies a maximum width for image or video containers. Accepts positive numbers and CSS values.
+     *
+     * Default value: 400
+     *
+     * The `minImageWidth`, `maxImageWidth`, `minImageHeight`, and `maxImageHeight` properties specify boundary values for container sizes. The resulting sizes are selected depending on the available screen space. If you want to specify the exact width and height, use the [`imageWidth`](#imageWidth) and [`imageHeight`](#imageHeight) properties.
+     */
     maxImageWidth: number;
+    /**
+     * Specifies a minimum width for image or video containers. Accepts positive numbers and CSS values.
+     *
+     * Default value: 200
+     *
+     * The `minImageWidth`, `maxImageWidth`, `minImageHeight`, and `maxImageHeight` properties specify boundary values for container sizes. The resulting sizes are selected depending on the available screen space. If you want to specify the exact width and height, use the [`imageWidth`](#imageWidth) and [`imageHeight`](#imageHeight) properties.
+     */
     minImageWidth: number;
+    /**
+     * Specifies a maximum height for image or video containers. Accepts positive numbers and CSS values.
+     *
+     * Default value: 266
+     *
+     * The `minImageWidth`, `maxImageWidth`, `minImageHeight`, and `maxImageHeight` properties specify boundary values for container sizes. The resulting sizes are selected depending on the available screen space. If you want to specify the exact width and height, use the [`imageWidth`](#imageWidth) and [`imageHeight`](#imageHeight) properties.
+     */
     maxImageHeight: number;
+    /**
+     * Specifies a minimum height for image or video containers. Accepts positive numbers and CSS values.
+     *
+     * Default value: 133
+     *
+     * The `minImageWidth`, `maxImageWidth`, `minImageHeight`, and `maxImageHeight` properties specify boundary values for container sizes. The resulting sizes are selected depending on the available screen space. If you want to specify the exact width and height, use the [`imageWidth`](#imageWidth) and [`imageHeight`](#imageHeight) properties.
+     */
     minImageHeight: number;
     private readonly isResponsive: any;
     private readonly exactSizesAreEmpty: any;

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

@@ -95,10 +95,9 @@ export declare class MatrixDropdownColumn extends Base implements ILocalizableOw
     readonly locTitle: LocalizableString;
     readonly fullTitle: string;
     /*
-    * Marks the column as required. If a respondent skips any cell in a required column, the matrix displays a validation error.
+    * Marks the column as required. If a respondent skips any cell in a required column, the matrix displays a [validation error](#requiredErrorText).
     *
     * If you want to mark the column as required based on a condition, specify the [`requiredIf`](#requiredIf) property.
-    * @see requiredErrorText
     * @see visible
     * @see readOnly
     */

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

@@ -85,6 +85,7 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
     */
     allowRowsDragAndDrop: boolean;
     readonly isRowsDragAndDrop: boolean;
+    lockedRowCount: number;
     readonly iconDragElement: string;
     protected createRenderedTable(): QuestionMatrixDropdownRenderedTable;
     private rowCountValue: any;