survey-core 1.9.136 → 1.9.138

package/typings/question_imagepicker.d.ts

@@ -65,11 +65,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
      */
     get imageHeight(): number;
     set imageHeight(val: number);
@@ -78,11 +79,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
      */
     get imageWidth(): number;
     set imageWidth(val: number);
@@ -113,9 +115,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 get isResponsive();
     private get exactSizesAreEmpty();

package/typings/question_matrixdropdowncolumn.d.ts

@@ -101,10 +101,9 @@ export declare class MatrixDropdownColumn extends Base implements ILocalizableOw
     get locTitle(): LocalizableString;
     get 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/typings/question_matrixdynamic.d.ts

@@ -91,6 +91,8 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
     get allowRowsDragAndDrop(): boolean;
     set allowRowsDragAndDrop(val: boolean);
     get isRowsDragAndDrop(): boolean;
+    get lockedRowCount(): number;
+    set lockedRowCount(val: number);
     get iconDragElement(): string;
     protected createRenderedTable(): QuestionMatrixDropdownRenderedTable;
     private get rowCountValue();

package/typings/question_multipletext.d.ts

@@ -6,6 +6,7 @@ import { QuestionTextModel } from "./question_text";
 import { SurveyError } from "./survey-error";
 import { ILocalizableOwner, LocalizableString } from "./localizablestring";
 import { HashTable } from "./helpers";
+import { InputMaskBase } from "./mask/mask_base";
 export interface IMultipleTextData extends ILocalizableOwner, IPanel {
     getSurvey(): ISurvey;
     getTextProcessor(): ITextProcessor;
@@ -21,9 +22,9 @@ export declare class MultipleTextEditorModel extends QuestionTextModel {
     get a11y_input_ariaDescribedBy(): string;
 }
 /**
- * A class that describes an item in a [Multiple Textboxes](https://surveyjs.io/form-library/documentation/api-reference/multiple-text-entry-question-model) question.
+ * A class that describes an [item](https://surveyjs.io/form-library/documentation/api-reference/multiple-text-entry-question-model#items) in a Multiple Textboxes question.
  *
- * [View Demo](https://surveyjs.io/form-library/examples/multiple-text-box-question/)
+ * [View Demo](https://surveyjs.io/form-library/examples/multiple-text-box-question/ (linkStyle))
  */
 export declare class MultipleTextItemModel extends Base implements IValidatorOwner, ISurveyData, ISurveyImpl {
     private editorValue;
@@ -34,7 +35,10 @@ export declare class MultipleTextItemModel extends Base implements IValidatorOwn
     get id(): string;
     getOriginalObj(): Base;
     /**
-     * The item name.
+     * An item ID that is not visible to respondents.
+     *
+     * > Item IDs must be unique.
+     * @see title
      */
     get name(): string;
     set name(val: string);
@@ -47,33 +51,34 @@ export declare class MultipleTextItemModel extends Base implements IValidatorOwn
     setData(data: IMultipleTextData): void;
     focusIn: () => void;
     /**
-     * Set this property to true, to make the item a required. If a user doesn't fill the item then a validation error will be generated.
+     * Marks the item as required. If a respondent leaves this item empty, the question displays a [validation error](#requiredErrorText).
      */
     get isRequired(): boolean;
     set isRequired(val: boolean);
     /**
-     * Use this property to change the default input type.
+     * A value passed on to the [`type`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#input_types) attribute of the underlying `<input>` element.
+     *
+     * Default value: `"text"`
      */
     get inputType(): string;
     set inputType(val: string);
     /**
-     * Item title. If it is empty, the item name is rendered as title. This property supports markdown.
-     * @see name
+     * A user-friendly item label to display. If `title` is undefined, [`name`](https://surveyjs.io/form-library/documentation/api-reference/multipletextitemmodel#name) is displayed instead.
      */
     get title(): string;
     set title(val: string);
     get locTitle(): LocalizableString;
     get fullTitle(): string;
     /**
-     * The maximum text length. If it is -1, defaul value, then the survey maxTextLength property will be used.
-     * If it is 0, then the value is unlimited
-     * @see SurveyModel.maxTextLength
+     * The maximum text length measured in characters. Assign 0 if the length should be unlimited.
+     *
+     * Default value: -1 (inherits the actual value from the `SurveyModel`'s [`maxTextLength`](https://surveyjs.io/form-library/documentation/surveymodel#maxTextLength) property).
      */
     get maxLength(): number;
     set maxLength(val: number);
     getMaxLength(): any;
     /**
-     * The input place holder.
+     * A placeholder for the input field.
      */
     get placeholder(): string;
     set placeholder(val: string);
@@ -82,39 +87,83 @@ export declare class MultipleTextItemModel extends Base implements IValidatorOwn
     set placeHolder(val: string);
     get locPlaceHolder(): LocalizableString;
     /**
-     * The custom text that will be shown on required error. Use this property, if you do not want to show the default text.
+     * Specifies a custom error message for a [required item](#isRequired).
      */
     get requiredErrorText(): string;
     set requiredErrorText(val: string);
     get locRequiredErrorText(): LocalizableString;
     /**
-     * The input size.
+     * A value passed on to the [`size`](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/size) attribute of the underlying `<input>` element.
+     *
+     * If you want to set a uniform `size` for all text box items, use the [`itemSize`](https://surveyjs.io/form-library/documentation/api-reference/multiple-text-entry-question-model#itemSize) within the Multiple Textboxes configuration.
      */
     get size(): number;
     set size(val: number);
     /**
-     * An expression used to calculate the [defaultValue](https://surveyjs.io/form-library/documentation/question#defaultValue).
+     * An [expression](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions) used to calculate the default item value.
+     * @see minValueExpression
+     * @see maxValueExpression
      */
     get defaultValueExpression(): string;
     set defaultValueExpression(val: string);
     /**
-     * The minimum value specified as an expression. For example, `"minValueExpression": "today(-1)"` sets the minimum value to yesterday.
+     * An [expression](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions) used to calculate the minimum item value.
+     * @see maxValueExpression
+     * @see defaultValueExpression
      */
     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.
+     * An [expression](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions) used to calculate the maximum item value.
+     * @see minValueExpression
+     * @see defaultValueExpression
      */
     get maxValueExpression(): string;
     set maxValueExpression(val: string);
     /**
-     * The list of question validators.
+     * Item validators.
+     *
+     * [Data Validation](https://surveyjs.io/form-library/documentation/data-validation (linkStyle))
      */
     get validators(): Array<SurveyValidator>;
     set validators(val: Array<SurveyValidator>);
     getValidators(): Array<SurveyValidator>;
     /**
-     * The item value.
+     * Specifies the type of a mask applied to the input.
+     *
+     * Possible values:
+     *
+     * - `"none"` (default)
+     * - `"numeric"`
+     * - `"currency"`
+     * - `"datetime"`
+     * - `"pattern"`
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/masked-input-fields/ (linkStyle))
+     * @see maskSettings
+     */
+    get maskType(): string;
+    set maskType(val: string);
+    /**
+     * An object with properties that configure the mask applied to the input.
+     *
+     * Available properties depend on the specified [`maskType`](#maskType) and belong to corresponding classes. Refer to the class APIs for a full list of properties:
+     *
+     * | `maskType` | Class |
+     * | ---------- | ----- |
+     * | `"numeric"` | [`InputMaskNumeric`](https://surveyjs.io/form-library/documentation/api-reference/inputmasknumeric) |
+     * | `"currency"` | [`InputMaskCurrency`](https://surveyjs.io/form-library/documentation/api-reference/inputmaskcurrency) |
+     * | `"datetime"` | [`InputMaskDateTime`](https://surveyjs.io/form-library/documentation/api-reference/inputmaskdatetime) |
+     * | `"pattern"` | [`InputMaskPattern`](https://surveyjs.io/form-library/documentation/api-reference/inputmaskpattern) |
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/masked-input-fields/ (linkStyle))
+     */
+    get maskSettings(): InputMaskBase;
+    set maskSettings(val: InputMaskBase);
+    get inputTextAlignment(): "left" | "right" | "auto";
+    set inputTextAlignment(val: "left" | "right" | "auto");
+    /**
+     * An item value.
      */
     get value(): any;
     set value(value: any);
@@ -161,9 +210,9 @@ export declare class QuestionMultipleTextModel extends Question implements IMult
     private editorsOnSurveyLoad;
     private performForEveryEditor;
     /**
-     * Gets or sets an array of `MultipleTextItemModel` objects that represent input items.
+     * Gets or sets an array of [`MultipleTextItemModel`](https://surveyjs.io/form-library/documentation/api-reference/multipletextitemmodel) objects that represent input items.
      *
-     * This property accepts an array of objects with the following structure:
+     * Each object in this array should have at least the following properties:
      *
      * ```js
      * {
@@ -186,6 +235,7 @@ export declare class QuestionMultipleTextModel extends Question implements IMult
      */
     addItem(name: string, title?: string): MultipleTextItemModel;
     getItemByName(name: string): MultipleTextItemModel;
+    getElementsInDesign(includeHidden?: boolean): Array<IElement>;
     addConditionObjectsByContext(objects: Array<IConditionObject>, context: any): void;
     protected collectNestedQuestionsCore(questions: Question[], visibleOnly: boolean): void;
     getConditionJson(operator?: string, path?: string): any;

package/typings/question_ranking.d.ts

@@ -1,7 +1,9 @@
 import { ISurveyImpl } from "./base-interfaces";
 import { DragDropRankingChoices } from "./dragdrop/ranking-choices";
+import { DragDropRankingSelectToRank } from "./dragdrop/ranking-select-to-rank";
 import { ItemValue } from "./itemvalue";
 import { QuestionCheckboxModel } from "./question_checkbox";
+import { AnimationGroup } from "./utils/animation";
 /**
  * A class that describes the Ranking question type.
  *
@@ -21,6 +23,7 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
     get ghostPositionCssClass(): string;
     getItemIndexClasses(item: ItemValue): string;
     getNumberByIndex(index: number): string;
+    private updateRankingChoicesSync;
     setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
     isAnswerCorrect(): boolean;
     get requireStrictCompare(): boolean;
@@ -29,16 +32,24 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
     localeChanged: () => void;
     private addToValueByVisibleChoices;
     private removeFromValueByVisibleChoices;
+    private getChoicesAnimation;
+    private _rankingChoicesAnimation;
+    get rankingChoicesAnimation(): AnimationGroup<ItemValue>;
+    private _unRankingChoicesAnimation;
+    get unRankingChoicesAnimation(): AnimationGroup<ItemValue>;
     get rankingChoices(): Array<ItemValue>;
+    set rankingChoices(val: Array<ItemValue>);
     get unRankingChoices(): Array<ItemValue>;
+    set unRankingChoices(val: Array<ItemValue>);
     private updateRankingChoices;
+    updateUnRankingChoices(newRankingChoices: Array<ItemValue>): void;
     private updateRankingChoicesSelectToRankMode;
     dragDropRankingChoices: DragDropRankingChoices;
     currentDropTarget: ItemValue;
     dropTargetNodeMove: string;
     endLoadingFromJson(): void;
     private setDragDropRankingChoices;
-    protected createDragDropRankingChoices(): DragDropRankingChoices;
+    protected createDragDropRankingChoices(): DragDropRankingChoices | DragDropRankingSelectToRank;
     handlePointerDown: (event: PointerEvent, choice: ItemValue, node: HTMLElement) => void;
     private isDragStartNodeValid;
     private get allowStartDrag();

package/typings/question_text.d.ts

@@ -60,6 +60,8 @@ export declare class QuestionTextModel extends QuestionTextBase {
     onSurveyLoad(): void;
     /**
      * A value passed on to the [`type`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#input_types) attribute of the underlying `<input>` element.
+     *
+     * Default value: `"text"`
      */
     get inputType(): string;
     set inputType(val: string);

package/typings/survey-element.d.ts

@@ -324,7 +324,7 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
     protected setPage(parent: IPanel, newPage: IPage): void;
     protected getSearchableLocKeys(keys: Array<string>): void;
     get isDefaultV2Theme(): boolean;
-    get hasParent(): any;
+    get hasParent(): boolean;
     isSingleInRow: boolean;
     private shouldAddRunnerStyles;
     protected get isCompact(): boolean;
@@ -399,5 +399,19 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
     protected getAdditionalTitleToolbar(): ActionContainer | null;
     protected getCssTitle(cssClasses: any): string;
     localeChanged(): void;
+    private wrapperElement?;
+    setWrapperElement(element?: HTMLElement): void;
+    getWrapperElement(): HTMLElement;
+    private _renderedIsExpanded;
+    private _isAnimatingCollapseExpand;
+    private set isAnimatingCollapseExpand(value);
+    private get isAnimatingCollapseExpand();
+    private getExpandCollapseAnimationOptions;
+    private animationCollapsed;
+    set renderedIsExpanded(val: boolean);
+    get renderedIsExpanded(): boolean;
+    private animationAllowedValue;
+    get animationAllowed(): boolean;
+    set animationAllowed(val: boolean);
     dispose(): void;
 }

package/typings/utils/animation.d.ts

@@ -0,0 +1,50 @@
+export interface AnimationOptions {
+    cssClass: string;
+    onBeforeRunAnimation?: (element: HTMLElement) => void;
+    onAfterRunAnimation?: (element: HTMLElement) => void;
+}
+export interface IAnimationConsumer<T extends Array<any> = []> {
+    getLeaveOptions(...args: T): AnimationOptions;
+    getEnterOptions(...args: T): AnimationOptions;
+    getAnimatedElement(...args: T): HTMLElement;
+    isAnimationEnabled(): boolean;
+}
+export declare class AnimationUtils {
+    private getMsFromRule;
+    private getAnimationsCount;
+    private getAnimationDuration;
+    private cancelQueue;
+    protected onAnimationEnd(element: HTMLElement, callback: (isCancel?: boolean) => void, options: AnimationOptions): void;
+    protected beforeAnimationRun(element: HTMLElement, options: AnimationOptions | AnimationOptions): void;
+    protected runLeaveAnimation(element: HTMLElement, options: AnimationOptions, callback: () => void): void;
+    protected runEnterAnimation(element: HTMLElement, options: AnimationOptions): void;
+    cancel(): void;
+}
+export declare class AnimationPropertyUtils extends AnimationUtils {
+    onEnter(getElement: () => HTMLElement, options: AnimationOptions): void;
+    onLeave(getElement: () => HTMLElement, callback: () => void, options: AnimationOptions): void;
+}
+export declare class AnimationGroupUtils<T> extends AnimationUtils {
+    onEnter(getElement: (el: T) => HTMLElement, getOptions: (el: T) => AnimationOptions, elements: Array<T>): void;
+    onLeave(getElement: (el: T) => HTMLElement, callback: () => void, getOptions: (el: T) => AnimationOptions, elements: Array<T>): void;
+}
+declare abstract class AnimationProperty<T, S extends Array<any> = []> {
+    protected animationOptions: IAnimationConsumer<S>;
+    protected update: (val: T) => void;
+    protected getCurrentValue: () => T;
+    constructor(animationOptions: IAnimationConsumer<S>, update: (val: T) => void, getCurrentValue: () => T);
+    protected animation: AnimationUtils;
+    protected abstract _sync(newValue: T): void;
+    private _debouncedSync;
+    sync(newValue: T): void;
+    cancel(): void;
+}
+export declare class AnimationBoolean extends AnimationProperty<boolean> {
+    protected animation: AnimationPropertyUtils;
+    protected _sync(newValue: boolean): void;
+}
+export declare class AnimationGroup<T> extends AnimationProperty<Array<T>, [T]> {
+    protected animation: AnimationGroupUtils<T>;
+    protected _sync(newValue: Array<T>): void;
+}
+export {};

package/typings/utils/taskmanager.d.ts

@@ -0,0 +1,28 @@
+export interface IExecutable {
+    id?: string;
+    execute: () => void;
+    isCompleted: boolean;
+    dispose?: () => void;
+}
+export declare class Task implements IExecutable {
+    private func;
+    private isMultiple;
+    private _isCompleted;
+    constructor(func: () => void, isMultiple?: boolean);
+    execute: () => void;
+    discard(): void;
+    get isCompleted(): boolean;
+}
+export declare class TaskManger {
+    private interval;
+    private static instance;
+    private static tasks;
+    private constructor();
+    static Instance(): TaskManger;
+    private tick;
+    static schedule(task: IExecutable): void;
+}
+export declare function debounce<T extends (...args: any) => void>(func: T): {
+    run: T;
+    cancel: () => void;
+};