survey-core 1.12.9 → 1.12.11

package/typings/packages/survey-core/src/popup-dropdown-view-model.d.ts

@@ -4,8 +4,6 @@ import { PopupModel } from "./popup";
 import { PopupBaseViewModel } from "./popup-view-model";
 export declare function calculateIsTablet(windowWidth?: number, windowHeight?: number): boolean;
 export declare class PopupDropdownViewModel extends PopupBaseViewModel {
-    targetElement?: HTMLElement;
-    areaElement?: HTMLElement;
     static readonly tabletSizeBreakpoint = 600;
     private scrollEventCallBack;
     private calculateIsTablet;
@@ -25,8 +23,8 @@ export declare class PopupDropdownViewModel extends PopupBaseViewModel {
     popupDirection: string;
     pointerTarget: IPosition;
     private recalculatePositionHandler;
-    constructor(model: PopupModel, targetElement?: HTMLElement, areaElement?: HTMLElement);
-    setComponentElement(componentRoot: HTMLElement, targetElement?: HTMLElement | null, areaElement?: HTMLElement | null): void;
+    constructor(model: PopupModel);
+    setComponentElement(componentRoot: HTMLElement): void;
     resetComponentElement(): void;
     updateOnShowing(): void;
     private get shouldCreateResizeCallback();

package/typings/packages/survey-core/src/popup-utils.d.ts

@@ -1,4 +1,4 @@
 import { IDialogOptions, PopupModel } from "./popup";
 import { PopupBaseViewModel } from "./popup-view-model";
 export declare function createPopupModalViewModel(options: IDialogOptions, rootElement?: HTMLElement): PopupBaseViewModel;
-export declare function createPopupViewModel(model: PopupModel, targetElement?: HTMLElement): PopupBaseViewModel;
+export declare function createPopupViewModel(model: PopupModel): PopupBaseViewModel;

package/typings/packages/survey-core/src/popup-view-model.d.ts

@@ -75,7 +75,7 @@ export declare class PopupBaseViewModel extends Base implements IAnimationConsum
     cancel(): void;
     dispose(): void;
     initializePopupContainer(): void;
-    setComponentElement(componentRoot: HTMLElement, targetElement?: HTMLElement | null, areaElement?: HTMLElement | null): void;
+    setComponentElement(componentRoot: HTMLElement): void;
     resetComponentElement(): void;
     protected preventScrollOuside(event: any, deltaY: number): void;
 }

package/typings/packages/survey-core/src/popup.d.ts

@@ -6,6 +6,8 @@ export interface IPopupOptionsBase {
     onShow?: () => void;
     onCancel?: () => void;
     onDispose?: () => void;
+    getTargetCallback?: (container: HTMLElement) => HTMLElement;
+    getAreaCallback?: (container: HTMLElement) => HTMLElement;
     cssClass?: string;
     title?: string;
     verticalPosition?: VerticalPosition;
@@ -30,6 +32,8 @@ export declare class PopupModel<T = any> extends Base implements IPopupOptionsBa
     onHide: () => void;
     onShow: () => void;
     onDispose: () => void;
+    getTargetCallback?: (container: HTMLElement) => HTMLElement;
+    getAreaCallback?: (container: HTMLElement) => HTMLElement;
     contentComponentName: string;
     contentComponentData: T;
     verticalPosition: VerticalPosition;

package/typings/packages/survey-core/src/question.d.ts

@@ -753,6 +753,8 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     protected convertFuncValuetoQuestionValue(val: any): any;
     private runExpressionSetValueCore;
     private runExpressionSetValue;
+    protected startSetValueOnExpression(): void;
+    protected finishSetValueOnExpression(): void;
     private runDefaultValueExpression;
     /**
      * A comment to the selected question value. Enable the `showCommentArea` property to allow users to leave comments.

package/typings/packages/survey-core/src/question_buttongroup.d.ts

@@ -29,7 +29,7 @@ export declare class ButtonGroupItemModel {
     constructor(question: QuestionButtonGroupModel, item: ItemValue, index: number);
     get value(): any;
     get iconName(): string;
-    get iconSize(): number;
+    get iconSize(): string | number;
     get caption(): LocalizableString;
     get showCaption(): any;
     get isRequired(): boolean;

package/typings/packages/survey-core/src/question_matrixdropdowncolumn.d.ts

@@ -30,7 +30,7 @@ export declare class MatrixDropdownColumn extends Base implements ILocalizableOw
     private indexValue;
     private _hasVisibleCell;
     private _visiblechoices;
-    constructor(name: string, title?: string);
+    constructor(name: string, title?: string, colOwner?: IMatrixColumnOwner);
     getOriginalObj(): Base;
     getClassNameProperty(): string;
     getSurvey(live?: boolean): ISurvey;
@@ -330,7 +330,7 @@ export declare class MatrixDropdownColumn extends Base implements ILocalizableOw
     defaultCellTypeChanged(): void;
     protected calcCellQuestionType(row: MatrixDropdownRowModelBase): string;
     private getDefaultCellQuestionType;
-    protected updateTemplateQuestion(newCellType?: string): void;
+    protected updateTemplateQuestion(newCellType?: string, name?: string, title?: string): void;
     protected createNewQuestion(cellType: string): Question;
     private setParentQuestionToTemplate;
     private previousChoicesId;

package/typings/packages/survey-core/src/survey-events-api.d.ts

@@ -212,6 +212,10 @@ export interface ValueChangeBaseEvent extends QuestionEventMixin {
      * The `name` of the question whose value is being changed. If you use the [`valueName`](https://surveyjs.io/form-library/documentation/api-reference/text-entry-question-model#valueName) property, this parameter contains its value.
      */
     name: string;
+    /**
+     * A value that indicates what caused the value change: an [expression](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions) evaluation or a run of a [trigger](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#conditional-survey-logic-triggers). If the value is changed for other reasons, this parameter is `undefined`.
+     */
+    reason: "trigger" | "expression" | undefined;
 }
 export interface ValueChangedEvent extends ValueChangeBaseEvent {
     /**
@@ -526,16 +530,16 @@ export interface OpenFileChooserEvent {
      */
     input: HTMLInputElement;
     /**
-     * A survey element (question, panel, page, or survey) or a theme JSON schema for which this event is raised.
+     * A question for which this event is raised.
      */
     element: Base;
     /**
      * The type of the element passed as the `options.element` parameter.\
-     * Possible values: `"theme"`, `"header"`, or any value returned from the [`getType()`](https://surveyjs.io/form-library/documentation/api-reference/question#getType) method.
+     * Possible values: any value returned from the [`getType()`](https://surveyjs.io/form-library/documentation/api-reference/question#getType) method.
      */
     elementType: String;
     /**
-     * The name of the survey element property or theme property for which files are being selected.
+     * The name of the survey element property for which files are being selected.
      */
     propertyName: String;
     /**

package/typings/packages/survey-core/src/survey.d.ts

@@ -373,9 +373,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     onGetResult: EventBase<SurveyModel, GetResultEvent>;
     /**
-     * An event that is raised when Survey Creator opens a dialog window for users to select files.
-     * @see onUploadFile
-     * @see uploadFiles
+     * An event that is raised when a respondent opens a dialog window to select files.
+     * @see chooseFiles
      */
     onOpenFileChooser: EventBase<SurveyModel, OpenFileChooserEvent>;
     /**
@@ -708,7 +707,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     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).
+     * An event that allows you to add, delete, or modify actions in the footer of a [Panel](https://surveyjs.io/form-library/documentation/panelmodel). This panel may belong to a [Dynamic Panel](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model) or be a standalone survey element.
      * @see [IAction](https://surveyjs.io/form-library/documentation/api-reference/iaction)
      */
     onGetPanelFooterActions: EventBase<SurveyModel, GetPanelFooterActionsEvent>;
@@ -1381,6 +1380,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * @param callback A callback function that you can use to access the calculation result if the expression uses asynchronous functions.
      */
     runExpression(expression: string, callback?: (res: any) => void): any;
+    private setValueOnExpressionCounter;
+    get isSettingValueOnExpression(): boolean;
+    startSetValueOnExpression(): void;
+    finishSetValueOnExpression(): void;
     /**
      * Calculates a given [expression](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions) and returns `true` or `false`.
      * @param expression An expression to calculate.
@@ -2217,6 +2220,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private isSmoothScrollEnabled;
     private resizeObserver;
     afterRenderSurvey(htmlElement: any): void;
+    beforeDestroySurveyElement(): void;
     /**
      * An event that is raised when the survey's width or height is changed.
      */
@@ -2273,6 +2277,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     matrixCellValidate(question: QuestionMatrixDropdownModelBase, options: MatrixCellValidateEvent): SurveyError;
     dynamicPanelAdded(question: QuestionPanelDynamicModel, panelIndex?: number, panel?: PanelModel): void;
     dynamicPanelRemoved(question: QuestionPanelDynamicModel, panelIndex: number, panel: PanelModel): void;
+    private hasQuestionVisibleIndeces;
     dynamicPanelRemoving(question: QuestionPanelDynamicModel, panelIndex: number, panel: PanelModel): boolean;
     dynamicPanelItemValueChanged(question: IQuestion, options: any): void;
     dynamicPanelGetTabTitle(question: IQuestion, options: any): void;
@@ -2465,11 +2470,13 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * @see addNewPage
      */
     createNewPage(name: string): PageModel;
+    private getValueChangeReason;
     protected questionOnValueChanging(valueName: string, newValue: any, questionValueName?: string): any;
     protected updateQuestionValue(valueName: string, newValue: any): void;
     private checkQuestionErrorOnValueChanged;
     private checkQuestionErrorOnValueChangedCore;
     private checkErrorsOnValueChanging;
+    private fireOnValueChanged;
     protected notifyQuestionOnValueChanged(valueName: string, newValue: any, questionName: string): void;
     private isRunningElementsBindings;
     private updateVisibleIndexAfterBindings;
@@ -2525,6 +2532,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     protected onLoadSurveyFromService(): void;
     private resetVisibleIndexes;
     private updateVisibleIndexes;
+    private updatePageElementsVisibleIndexes;
+    private getStartVisibleIndex;
     private updatePageVisibleIndexes;
     fromJSON(json: any, options?: ILoadFromJSONOptions): void;
     startLoadingFromJson(json?: any): void;
@@ -2871,6 +2880,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     setTriggerValue(name: string, value: any, isVariable: boolean): void;
     copyTriggerValue(name: string, fromName: string, copyDisplayValue: boolean): void;
     triggerExecuted(trigger: Trigger): void;
+    private setValueFromTriggerCounter;
+    get isSettingValueFromTrigger(): boolean;
+    private startSetValueFromTrigger;
+    private finishSetValueFromTrigger;
     private focusingQuestionInfo;
     private isMovingQuestion;
     startMovingQuestion(): void;

package/typings/packages/survey-core/src/surveyStrings.d.ts

@@ -25,6 +25,7 @@ export declare var surveyLocalization: {
     getLocales: (removeDefaultLoc?: boolean) => Array<string>;
     onGetExternalString: (name: string, locale: string) => string;
 };
+export declare function getLocaleString(strName: string, locale?: string): string;
 export declare var surveyStrings: {
     pagePrevText: string;
     pageNextText: string;

package/typings/packages/survey-core/src/utils/animation.d.ts

@@ -16,11 +16,21 @@ interface IGroupAnimationInfo {
     isDeletingRunning: boolean;
     isAddingRunning: boolean;
 }
+interface IGroupAnimationCompareInfo<T> {
+    addedItems: Array<T>;
+    deletedItems: Array<T>;
+    reorderedItems: Array<{
+        item: T;
+        movedForward: boolean;
+    }>;
+    mergedItems: Array<T>;
+}
 export interface IAnimationGroupConsumer<T> extends IAnimationConsumer<[T]> {
     getLeaveOptions?(item: T, info?: IGroupAnimationInfo): AnimationOptions;
     getEnterOptions?(item: T, info?: IGroupAnimationInfo): AnimationOptions;
     getReorderOptions?(item: T, movedForward: boolean, info?: IGroupAnimationInfo): AnimationOptions;
     getKey?: (item: T) => any;
+    onCompareArrays?(options: IGroupAnimationCompareInfo<T>): void;
     allowSyncRemovalAddition?: boolean;
 }
 export declare class AnimationUtils {

package/typings/packages/survey-core/src/utils/popup.d.ts

@@ -27,7 +27,10 @@ export declare class Rect implements ISize, INumberPosition {
 export declare class PopupUtils {
     static bottomIndent: number;
     static calculatePosition(targetRect: Rect, height: number, width: number, verticalPosition: VerticalPosition, horizontalPosition: HorizontalPosition, positionMode?: PositionMode): INumberPosition;
-    static getCorrectedVerticalDimensions(top: number, height: number, windowHeight: number, verticalPosition: VerticalPosition, canShrink?: boolean): {
+    static getCorrectedVerticalDimensions(top: number, height: number, windowHeight: number, verticalPosition: VerticalPosition, canShrink?: boolean, margins?: {
+        top: number;
+        bottom: number;
+    }): {
         height: number;
         top: number;
     };

package/typings/packages/survey-core/src/utils/responsivity-manager.d.ts

@@ -5,7 +5,7 @@ interface IDimensions {
     offset: number;
 }
 export declare class ResponsivityManager {
-    protected container: HTMLDivElement;
+    container: HTMLDivElement;
     private model;
     private itemsSelector;
     private dotsItemSize;
@@ -17,6 +17,8 @@ export declare class ResponsivityManager {
     private separatorAddConst;
     private paddingSizeConst;
     private dotsSizeConst;
+    private dotsIconClass;
+    private iconClass;
     protected recalcMinDimensionConst: boolean;
     getComputedStyle: (elt: Element) => CSSStyleDeclaration;
     constructor(container: HTMLDivElement, model: AdaptiveActionContainer, itemsSelector: string, dotsItemSize?: number, delayedUpdateFunction?: (callback: () => void) => void);

package/typings/packages/survey-core/src/utils/text-area.d.ts

@@ -31,6 +31,7 @@ export declare class TextAreaModel {
     private onPropertyChangedCallback;
     constructor(options: ITextArea);
     setElement(element: HTMLTextAreaElement | null): void;
+    resetElement(): void;
     getTextValue(): string;
     onTextAreaChange(event: any): void;
     onTextAreaInput(event: any): void;

package/typings/packages/survey-core/src/utils/utils.d.ts

@@ -13,6 +13,7 @@ declare function findScrollableParent(element: HTMLElement): HTMLElement;
 declare function activateLazyRenderingChecks(id: string): void;
 declare function navigateToUrl(url: string): void;
 declare function wrapUrlForBackgroundImage(url: string): string;
+declare function isBase64URL(url: string): boolean;
 declare const renamedIcons: any;
 declare function getIconNameFromProxy(iconName: string): string;
 export declare function getNewIconName(iconName: string): string;
@@ -72,4 +73,4 @@ export declare function setPropertiesOnElementForAnimation(el: HTMLElement, styl
 export declare function prepareElementForVerticalAnimation(el: HTMLElement): void;
 export declare function cleanHtmlElementAfterAnimation(el: HTMLElement): void;
 export declare function roundTo2Decimals(number: number): number;
-export { mergeValues, getElementWidth, isContainerVisible, classesToSelector, compareVersions, confirmAction, confirmActionAsync, detectIEOrEdge, detectIEBrowser, loadFileFromBase64, isMobile, isShadowDOM, getElement, isElementVisible, findScrollableParent, activateLazyRenderingChecks, navigateToUrl, wrapUrlForBackgroundImage, createSvg, getIconNameFromProxy, increaseHeightByContent, getOriginalEvent, preventDefaults, findParentByClassNames, getFirstVisibleChild, chooseFiles, renamedIcons };
+export { mergeValues, getElementWidth, isContainerVisible, classesToSelector, compareVersions, confirmAction, confirmActionAsync, detectIEOrEdge, detectIEBrowser, loadFileFromBase64, isMobile, isShadowDOM, getElement, isElementVisible, findScrollableParent, activateLazyRenderingChecks, navigateToUrl, wrapUrlForBackgroundImage, createSvg, getIconNameFromProxy, increaseHeightByContent, getOriginalEvent, preventDefaults, findParentByClassNames, getFirstVisibleChild, chooseFiles, isBase64URL, renamedIcons };