survey-core 1.11.9 → 1.11.10

package/themes/solid-light-panelless.js

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

package/themes/solid-light-panelless.min.js

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

package/themes/solid-light.js

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

package/themes/solid-light.min.js

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - Survey JavaScript library v1.11.9
+ * surveyjs - Survey JavaScript library v1.11.10
  * 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.11.9
+ * surveyjs - Survey JavaScript library v1.11.10
  * 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.11.9
+ * surveyjs - Survey JavaScript library v1.11.10
  * 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.11.9
+ * surveyjs - Survey JavaScript library v1.11.10
  * 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.11.9
+ * surveyjs - Survey JavaScript library v1.11.10
  * 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.11.9
+ * surveyjs - Survey JavaScript library v1.11.10
  * 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.11.9
+ * surveyjs - Survey JavaScript library v1.11.10
  * 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.11.9
+ * surveyjs - Survey JavaScript library v1.11.10
  * 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.11.9
+ * surveyjs - Survey JavaScript library v1.11.10
  * 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-interfaces.d.ts

@@ -163,6 +163,7 @@ export interface ISurvey extends ITextProcessor, ISurveyErrorOwner {
     elementContentVisibilityChanged(element: ISurveyElement): void;
     onCorrectQuestionAnswer(question: IQuestion, options: any): void;
     processPopupVisiblityChanged(question: IQuestion, popupModel: PopupModel, visible: boolean): void;
+    processOpenDropdownMenu(question: IQuestion, options: IDropdownMenuOptions): void;
     chooseFiles(input: HTMLInputElement, callback: (files: File[]) => void, context?: {
         element: Base;
         item?: any;
@@ -330,3 +331,10 @@ export interface ISaveToJSONOptions {
     storeDefaults?: boolean;
     version?: string;
 }
+export interface IDropdownMenuOptions {
+    menuType: "dropdown" | "popup" | "overlay";
+    deviceType: "mobile" | "tablet" | "desktop";
+    hasTouchScreen: boolean;
+    screenHeight: number;
+    screenWidth: number;
+}

package/ts3.4/typings/dragdrop/core.d.ts

@@ -12,6 +12,7 @@ export declare abstract class DragDropCore<T> implements IDragDropEngine {
     protected ghostPositionChanged(): void;
     onDragStart: EventBase<DragDropCore<T>>;
     onDragEnd: EventBase<DragDropCore<T>>;
+    onDragClear: EventBase<DragDropCore<T>>;
     onBeforeDrop: EventBase<DragDropCore<T>, any>;
     onAfterDrop: EventBase<DragDropCore<T>, any>;
     draggedElement: any;

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

@@ -28,6 +28,7 @@ export declare class DropdownListModel extends Base {
     private loadQuestionChoices;
     private updateQuestionChoices;
     private updatePopupFocusFirstInputSelector;
+    private getDropdownMenuOptions;
     protected createPopup(): void;
     private setFilterStringToListModel;
     private setTextWrapEnabled;

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

@@ -77,7 +77,6 @@ export declare class Const extends Operand {
     protected getCorrectValue(value: any): any;
     protected isContentEqual(op: Operand): boolean;
     private isQuote;
-    private isBooleanValue;
 }
 export declare class Variable extends Const {
     private variableName;
@@ -117,8 +116,6 @@ export declare class OperandMaker {
     static throwInvalidOperatorError(op: string): void;
     static safeToString(operand: Operand, func: (op: Operand) => string): string;
     static toOperandString(value: string): string;
-    static isSpaceString(str: string): boolean;
-    static isNumeric(value: string): boolean;
     static isBooleanValue(value: string): boolean;
     static countDecimals(value: number): number;
     static plusMinus(a: number, b: number, res: number): number;

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

@@ -18,6 +18,8 @@ export declare class Helpers {
     static isValueObject(val: any, excludeArray?: boolean): boolean;
     static isNumber(value: any): boolean;
     static getNumber(value: any): number;
+    private static getNumberCore;
+    private static isStringHasOperator;
     private static prepareStringToNumber;
     static getMaxLength(maxLength: number, surveyLength: number): any;
     static getRemainingCharacterCounterText(newValue: string | undefined, maxLength: number | null): string;

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

@@ -2,11 +2,12 @@ import { IPosition, Rect } from "./utils/popup";
 import { CssClassBuilder } from "./utils/cssClassBuilder";
 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 static readonly tabletSizeBreakpoint;
     private calculateIsTablet;
     private resizeEventCallback;
     private resizeWindowCallback;

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

@@ -41,7 +41,7 @@ export declare class PopupModel<T = any> extends Base implements IPopupOptionsBa
     isFocusedContainer: boolean;
     cssClass: string;
     title: string;
-    overlayDisplayMode: "auto" | "overlay" | "dropdown-overlay";
+    overlayDisplayMode: "auto" | "tablet-dropdown-overlay" | "dropdown-overlay" | "plain";
     displayMode: "popup" | "overlay";
     positionMode: PositionMode;
     onVisibilityChanged: EventBase<PopupModel>;
@@ -55,6 +55,7 @@ export declare class PopupModel<T = any> extends Base implements IPopupOptionsBa
     hide(): void;
     recalculatePosition(isResetHeight: boolean): void;
     updateFooterActions(footerActions: Array<IAction>): Array<IAction>;
+    updateDisplayMode(menuType: "dropdown" | "popup" | "overlay"): void;
     onHiding(): void;
     dispose(): void;
 }

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

@@ -1,6 +1,6 @@
 import { HashTable } from "./helpers";
 import { EventBase } from "./base";
-import { IElement, IQuestion, IPanel, IConditionRunner, ISurveyImpl, IPage, ITitleOwner, IProgressInfo, ISurvey, IPlainDataOptions } from "./base-interfaces";
+import { IElement, IQuestion, IPanel, IConditionRunner, ISurveyImpl, IPage, ITitleOwner, IProgressInfo, ISurvey, IPlainDataOptions, IDropdownMenuOptions } from "./base-interfaces";
 import { SurveyElement } from "./survey-element";
 import { SurveyValidator, IValidatorOwner } from "./validator";
 import { TextPreProcessorValue } from "./textPreProcessor";
@@ -837,6 +837,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     validatedValue: any;
     getAllValues(): any;
     processPopupVisiblilityChanged(popupModel: PopupModel, visible: boolean): void;
+    processOpenDropdownMenu(options: IDropdownMenuOptions): void;
     protected onTextKeyDownHandler(event: any): void;
     transformToMobileView(): void;
     transformToDesktopView(): void;

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

@@ -43,6 +43,8 @@ export declare class QuestionFileModelBase extends Question {
     clearOnDeletingContainer(): void;
     protected onCheckForErrors(errors: Array<SurveyError>, isOnValueChanged: boolean): void;
     protected uploadFiles(files: File[]): void;
+    protected loadPreview(newValue: any): void;
+    protected onChangeQuestionValue(newValue: any): void;
 }
 /**
  * A class that describes the File Upload question type.
@@ -80,6 +82,8 @@ export declare class QuestionFileModel extends QuestionFileModelBase {
     startCameraAction: Action;
     cleanAction: Action;
     actionsContainer: ActionContainer;
+    private isFileLoadingValue;
+    protected isFileLoading: boolean;
     readonly fileNavigatorVisible: boolean;
     private readonly pagesCount: any;
     readonly actionsContainerVisible: boolean;
@@ -212,8 +216,6 @@ export declare class QuestionFileModel extends QuestionFileModelBase {
     protected readonly camera: Camera;
     canPreviewImage(fileItem: any): boolean;
     protected loadPreview(newValue: any): void;
-    private isFileLoadingValue;
-    protected isFileLoading: boolean;
     protected getIsQuestionReady(): boolean;
     private allFilesOk;
     private isFileImage;
@@ -226,7 +228,6 @@ export declare class QuestionFileModel extends QuestionFileModelBase {
     readonly fileRootCss: string;
     getFileDecoratorCss(): string;
     private onChange;
-    protected onChangeQuestionValue(newValue: any): void;
     protected calcCssClasses(css: any): any;
     onSurveyLoad(): void;
     protected needResponsiveness(): boolean;
@@ -260,7 +261,7 @@ export declare class QuestionFileModel extends QuestionFileModelBase {
 export declare class FileLoader {
     private fileQuestion;
     private callback;
-    constructor(fileQuestion: QuestionFileModel, callback: (status: string, files: any[]) => void);
+    constructor(fileQuestion: QuestionFileModelBase, callback: (status: string, files: any[]) => void);
     loaded: any[];
     load(files: Array<any>): void;
     dispose(): void;

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

@@ -96,8 +96,8 @@ export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixR
     *
     * Possible values:
     *
-    * - "initial" (default) - Preserves the original order of the `rows` array.
-    * - "random" - Arranges matrix rows in random order each time the question is displayed.
+    * - `"initial"` (default) - Preserves the original order of the `rows` array.
+    * - `"random"` - Arranges matrix rows in random order each time the question is displayed.
     * @see rows
     */
     rowsOrder: string;

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

@@ -29,6 +29,8 @@ export declare class QuestionSignaturePadModel extends QuestionFileModelBase {
     private fromUrl;
     private refreshCanvas;
     private updateValueHandler;
+    protected loadPreview(newValue: any): void;
+    onSurveyLoad(): void;
     initSignaturePad(el: HTMLElement): void;
     destroySignaturePad(el: HTMLElement): void;
     /*

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

@@ -151,6 +151,7 @@ export declare var settings: {
      * const item = new ItemValue("item1");
      * const itemString = item.toJSON(); // Produces { value: "item1", text: "item1" } instead of "item1"
      * ```
+     * @see [settings.parseNumber](https://surveyjs.io/form-library/documentation/api-reference/settings#parseNumber)
      */
     serialization: {
         itemValueSerializeAsObject: boolean;
@@ -618,4 +619,28 @@ export declare var settings: {
      * ```
      */
     storeUtcDates: boolean;
+    /**
+     * A function that allows you to define custom parsing rules for numbers represented as string values.
+     *
+     * The following code shows a template that you can use to implement the `parseNumber` function:
+     *
+     * ```js
+     * import { settings } from "survey-core";
+     *
+     * settings.parseNumber = (stringValue, numericValue) => {
+     *   if (typeof stringValue !== "string" || !stringValue)
+     *     return numericValue;
+     *   let parsedNumber = numericValue;
+     *   // ...
+     *   // Parsing the number according to custom parsing rules
+     *   // ...
+     *   return parsedNumber;
+     * };
+     * ```
+     * @param stringValue A number represented as a string value.
+     * @param numericValue A number parsed using a default parsing function. `NaN` if the original string is not a number.
+     * @returns A number that results from parsing the string value.
+     * @see [settings.serialization](https://surveyjs.io/form-library/documentation/api-reference/settings#serialization)
+     */
+    parseNumber: (stringValue: any, numericValue: number) => number;
 };

package/ts3.4/typings/survey-events-api.d.ts

@@ -1036,6 +1036,32 @@ export interface PopupVisibleChangedEvent extends QuestionEventMixin {
      */
     visible: boolean;
 }
+export interface OpenDropdownMenuEvent extends QuestionEventMixin {
+    /**
+     * A question for which the event is raised.
+     */
+    question: Question;
+    /**
+     * A device type.
+     */
+    deviceType: "mobile" | "tablet" | "desktop";
+    /**
+     * A Boolean value that indicates whether the current device supports touch gestures.
+     */
+    hasTouchScreen: boolean;
+    /**
+     * The height of the device screen in pixels.
+     */
+    screenHeight: number;
+    /**
+     * The width of the device screen in pixels.
+     */
+    screenWidth: number;
+    /**
+     * A menu type to use for the question: a classic dropdown, a pop-up dialog, or an overlay window. You can modify this parameter's value.
+     */
+    menuType: "dropdown" | "popup" | "overlay";
+}
 export interface ElementWrapperComponentEventMixin {
     element: any;
     wrapperName: string;

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

@@ -1,6 +1,6 @@
 import { JsonError } from "./jsonobject";
 import { Base, EventBase } from "./base";
-import { ISurvey, ISurveyData, ISurveyImpl, ITextProcessor, IQuestion, IPanel, IElement, IPage, ISurveyErrorOwner, ISurveyElement, IProgressInfo, IFindElement, ISurveyLayoutElement, IPlainDataOptions, LayoutElementContainer, IValueItemCustomPropValues, ILoadFromJSONOptions } from "./base-interfaces";
+import { ISurvey, ISurveyData, ISurveyImpl, ITextProcessor, IQuestion, IPanel, IElement, IPage, ISurveyErrorOwner, ISurveyElement, IProgressInfo, IFindElement, ISurveyLayoutElement, IPlainDataOptions, LayoutElementContainer, IValueItemCustomPropValues, ILoadFromJSONOptions, IDropdownMenuOptions } from "./base-interfaces";
 import { SurveyElementCore } from "./survey-element";
 import { ISurveyTriggerOwner, SurveyTrigger, Trigger } from "./trigger";
 import { CalculatedValue } from "./calculatedValue";
@@ -18,7 +18,7 @@ import { IAction, Action } from "./actions/action";
 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, MatrixDetailPanelVisibleChangedEvent, MatrixCellCreatingEvent, MatrixCellCreatedEvent, MatrixAfterCellRenderEvent, MatrixCellValueChangedEvent, MatrixCellValueChangingEvent, MatrixCellValidateEvent, DynamicPanelModifiedEvent, DynamicPanelRemovingEvent, TimerPanelInfoTextEvent, DynamicPanelItemValueChangedEvent, DynamicPanelGetTabTitleEvent, DynamicPanelCurrentIndexChangedEvent, IsAnswerCorrectEvent, DragDropAllowEvent, ScrollingElementToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, ElementContentVisibilityChangedEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent, ChoicesSearchEvent, OpenFileChooserEvent, ElementWrapperComponentNameEvent, ElementWrapperComponentDataEvent } 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, MatrixDetailPanelVisibleChangedEvent, MatrixCellCreatingEvent, MatrixCellCreatedEvent, MatrixAfterCellRenderEvent, MatrixCellValueChangedEvent, MatrixCellValueChangingEvent, MatrixCellValidateEvent, DynamicPanelModifiedEvent, DynamicPanelRemovingEvent, TimerPanelInfoTextEvent, DynamicPanelItemValueChangedEvent, DynamicPanelGetTabTitleEvent, DynamicPanelCurrentIndexChangedEvent, IsAnswerCorrectEvent, DragDropAllowEvent, ScrollingElementToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, ElementContentVisibilityChangedEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent, ChoicesSearchEvent, OpenFileChooserEvent, ElementWrapperComponentNameEvent, ElementWrapperComponentDataEvent, OpenDropdownMenuEvent } from "./survey-events-api";
 import { QuestionMatrixDropdownModelBase } from "./question_matrixdropdownbase";
 import { QuestionMatrixDynamicModel } from "./question_matrixdynamic";
 import { QuestionFileModel } from "./question_file";
@@ -710,9 +710,17 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     onGetExpressionDisplayValue: EventBase<SurveyModel, GetExpressionDisplayValueEvent>;
     /**
-     * An event that is raised after the visibility of a popup is changed. This event can be raised for [Single-](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model) and [Multi-Select Dropdown](https://surveyjs.io/form-library/documentation/api-reference/dropdown-tag-box-model) questions and [Rating](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model) questions [rendered as drop-down menus](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#displayMode).
+     * An event that is raised after the visibility of a popup is changed.
+     *
+     * This event can be raised for [Single-](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model) and [Multi-Select Dropdown](https://surveyjs.io/form-library/documentation/api-reference/dropdown-tag-box-model) questions and [Rating Scale](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model) questions [rendered as drop-down menus](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#displayMode), and [Multi-Select Matrix](https://surveyjs.io/form-library/documentation/api-reference/matrix-table-with-dropdown-list) questions that contain columns of the `"dropdown"` or `"tagbox"` [`cellType`](https://surveyjs.io/form-library/documentation/api-reference/matrix-table-with-dropdown-list#cellType).
      */
     onPopupVisibleChanged: EventBase<SurveyModel, PopupVisibleChangedEvent>;
+    /**
+     * An event that is raised when users open a drop-down menu.
+     *
+     * This event can be raised for [Single-](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model) and [Multi-Select Dropdown](https://surveyjs.io/form-library/documentation/api-reference/dropdown-tag-box-model) questions, [Rating Scale](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model) questions [rendered as drop-down menus](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#displayMode), and [Multi-Select Matrix](https://surveyjs.io/form-library/documentation/api-reference/matrix-table-with-dropdown-list) questions that contain columns of the `"dropdown"` or `"tagbox"` [`cellType`](https://surveyjs.io/form-library/documentation/api-reference/matrix-table-with-dropdown-list#cellType). Handle this event to change the drop-down menu type for specific questions or device types.
+     */
+    onOpenDropdownMenu: EventBase<SurveyModel, OpenDropdownMenuEvent>;
     onElementWrapperComponentName: EventBase<SurveyModel, ElementWrapperComponentNameEvent>;
     onElementWrapperComponentData: EventBase<SurveyModel, ElementWrapperComponentDataEvent>;
     constructor(jsonObj?: any, renderedElement?: any);
@@ -2761,6 +2769,7 @@ 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;
+    processOpenDropdownMenu(question: Question, options: IDropdownMenuOptions): void;
     /**
      * Applies a specified theme to the survey.
      *

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

@@ -15,6 +15,7 @@ declare function navigateToUrl(url: string): void;
 declare function wrapUrlForBackgroundImage(url: string): string;
 declare function getIconNameFromProxy(iconName: string): string;
 declare function createSvg(size: number | string, width: number, height: number, iconName: string, svgElem: any, title: string): void;
+export declare function getSafeUrl(url: string): string;
 export declare function unwrap<T>(value: T | (() => T)): T;
 export declare function getRenderedSize(val: string | number): number;
 export declare function getRenderedStyleSize(val: string | number): string;

package/typings/base-interfaces.d.ts

@@ -163,6 +163,7 @@ export interface ISurvey extends ITextProcessor, ISurveyErrorOwner {
     elementContentVisibilityChanged(element: ISurveyElement): void;
     onCorrectQuestionAnswer(question: IQuestion, options: any): void;
     processPopupVisiblityChanged(question: IQuestion, popupModel: PopupModel, visible: boolean): void;
+    processOpenDropdownMenu(question: IQuestion, options: IDropdownMenuOptions): void;
     chooseFiles(input: HTMLInputElement, callback: (files: File[]) => void, context?: {
         element: Base;
         item?: any;
@@ -330,3 +331,10 @@ export interface ISaveToJSONOptions {
     storeDefaults?: boolean;
     version?: string;
 }
+export interface IDropdownMenuOptions {
+    menuType: "dropdown" | "popup" | "overlay";
+    deviceType: "mobile" | "tablet" | "desktop";
+    hasTouchScreen: boolean;
+    screenHeight: number;
+    screenWidth: number;
+}

package/typings/dragdrop/core.d.ts

@@ -13,6 +13,7 @@ export declare abstract class DragDropCore<T> implements IDragDropEngine {
     protected ghostPositionChanged(): void;
     onDragStart: EventBase<DragDropCore<T>>;
     onDragEnd: EventBase<DragDropCore<T>>;
+    onDragClear: EventBase<DragDropCore<T>>;
     onBeforeDrop: EventBase<DragDropCore<T>, any>;
     onAfterDrop: EventBase<DragDropCore<T>, any>;
     draggedElement: any;

package/typings/dropdownListModel.d.ts

@@ -28,6 +28,7 @@ export declare class DropdownListModel extends Base {
     private loadQuestionChoices;
     private updateQuestionChoices;
     private updatePopupFocusFirstInputSelector;
+    private getDropdownMenuOptions;
     protected createPopup(): void;
     private setFilterStringToListModel;
     private setTextWrapEnabled;

package/typings/expressions/expressions.d.ts

@@ -77,7 +77,6 @@ export declare class Const extends Operand {
     protected getCorrectValue(value: any): any;
     protected isContentEqual(op: Operand): boolean;
     private isQuote;
-    private isBooleanValue;
 }
 export declare class Variable extends Const {
     private variableName;
@@ -118,8 +117,6 @@ export declare class OperandMaker {
     static throwInvalidOperatorError(op: string): void;
     static safeToString(operand: Operand, func: (op: Operand) => string): string;
     static toOperandString(value: string): string;
-    static isSpaceString(str: string): boolean;
-    static isNumeric(value: string): boolean;
     static isBooleanValue(value: string): boolean;
     static countDecimals(value: number): number;
     static plusMinus(a: number, b: number, res: number): number;

package/typings/helpers.d.ts

@@ -18,6 +18,8 @@ export declare class Helpers {
     static isValueObject(val: any, excludeArray?: boolean): boolean;
     static isNumber(value: any): boolean;
     static getNumber(value: any): number;
+    private static getNumberCore;
+    private static isStringHasOperator;
     private static prepareStringToNumber;
     static getMaxLength(maxLength: number, surveyLength: number): any;
     static getRemainingCharacterCounterText(newValue: string | undefined, maxLength: number | null): string;

package/typings/popup-dropdown-view-model.d.ts

@@ -2,11 +2,12 @@ import { IPosition, Rect } from "./utils/popup";
 import { CssClassBuilder } from "./utils/cssClassBuilder";
 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 static readonly tabletSizeBreakpoint;
     private calculateIsTablet;
     private resizeEventCallback;
     private resizeWindowCallback;

package/typings/popup.d.ts

@@ -41,7 +41,7 @@ export declare class PopupModel<T = any> extends Base implements IPopupOptionsBa
     isFocusedContainer: boolean;
     cssClass: string;
     title: string;
-    overlayDisplayMode: "auto" | "overlay" | "dropdown-overlay";
+    overlayDisplayMode: "auto" | "tablet-dropdown-overlay" | "dropdown-overlay" | "plain";
     displayMode: "popup" | "overlay";
     positionMode: PositionMode;
     onVisibilityChanged: EventBase<PopupModel>;
@@ -56,6 +56,7 @@ export declare class PopupModel<T = any> extends Base implements IPopupOptionsBa
     hide(): void;
     recalculatePosition(isResetHeight: boolean): void;
     updateFooterActions(footerActions: Array<IAction>): Array<IAction>;
+    updateDisplayMode(menuType: "dropdown" | "popup" | "overlay"): void;
     onHiding(): void;
     dispose(): void;
 }

package/typings/question.d.ts

@@ -1,6 +1,6 @@
 import { HashTable } from "./helpers";
 import { EventBase } from "./base";
-import { IElement, IQuestion, IPanel, IConditionRunner, ISurveyImpl, IPage, ITitleOwner, IProgressInfo, ISurvey, IPlainDataOptions } from "./base-interfaces";
+import { IElement, IQuestion, IPanel, IConditionRunner, ISurveyImpl, IPage, ITitleOwner, IProgressInfo, ISurvey, IPlainDataOptions, IDropdownMenuOptions } from "./base-interfaces";
 import { SurveyElement } from "./survey-element";
 import { SurveyValidator, IValidatorOwner } from "./validator";
 import { TextPreProcessorValue } from "./textPreProcessor";
@@ -873,6 +873,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     set validatedValue(val: any);
     getAllValues(): any;
     processPopupVisiblilityChanged(popupModel: PopupModel, visible: boolean): void;
+    processOpenDropdownMenu(options: IDropdownMenuOptions): void;
     protected onTextKeyDownHandler(event: any): void;
     transformToMobileView(): void;
     transformToDesktopView(): void;

package/typings/question_file.d.ts

@@ -45,6 +45,8 @@ export declare class QuestionFileModelBase extends Question {
     clearOnDeletingContainer(): void;
     protected onCheckForErrors(errors: Array<SurveyError>, isOnValueChanged: boolean): void;
     protected uploadFiles(files: File[]): void;
+    protected loadPreview(newValue: any): void;
+    protected onChangeQuestionValue(newValue: any): void;
 }
 /**
  * A class that describes the File Upload question type.
@@ -82,6 +84,9 @@ export declare class QuestionFileModel extends QuestionFileModelBase {
     startCameraAction: Action;
     cleanAction: Action;
     actionsContainer: ActionContainer;
+    private isFileLoadingValue;
+    protected get isFileLoading(): boolean;
+    protected set isFileLoading(val: boolean);
     get fileNavigatorVisible(): boolean;
     private get pagesCount();
     get actionsContainerVisible(): boolean;
@@ -224,9 +229,6 @@ export declare class QuestionFileModel extends QuestionFileModelBase {
     protected get camera(): Camera;
     canPreviewImage(fileItem: any): boolean;
     protected loadPreview(newValue: any): void;
-    private isFileLoadingValue;
-    protected get isFileLoading(): boolean;
-    protected set isFileLoading(val: boolean);
     protected getIsQuestionReady(): boolean;
     private allFilesOk;
     private isFileImage;
@@ -239,7 +241,6 @@ export declare class QuestionFileModel extends QuestionFileModelBase {
     get fileRootCss(): string;
     getFileDecoratorCss(): string;
     private onChange;
-    protected onChangeQuestionValue(newValue: any): void;
     protected calcCssClasses(css: any): any;
     onSurveyLoad(): void;
     protected needResponsiveness(): boolean;
@@ -273,7 +274,7 @@ export declare class QuestionFileModel extends QuestionFileModelBase {
 export declare class FileLoader {
     private fileQuestion;
     private callback;
-    constructor(fileQuestion: QuestionFileModel, callback: (status: string, files: any[]) => void);
+    constructor(fileQuestion: QuestionFileModelBase, callback: (status: string, files: any[]) => void);
     loaded: any[];
     load(files: Array<any>): void;
     dispose(): void;

package/typings/question_matrix.d.ts

@@ -100,8 +100,8 @@ export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixR
      *
      * Possible values:
      *
-     * - "initial" (default) - Preserves the original order of the `rows` array.
-     * - "random" - Arranges matrix rows in random order each time the question is displayed.
+     * - `"initial"` (default) - Preserves the original order of the `rows` array.
+     * - `"random"` - Arranges matrix rows in random order each time the question is displayed.
      * @see rows
      */
     get rowsOrder(): string;

package/typings/question_signaturepad.d.ts

@@ -29,6 +29,8 @@ export declare class QuestionSignaturePadModel extends QuestionFileModelBase {
     private fromUrl;
     private refreshCanvas;
     private updateValueHandler;
+    protected loadPreview(newValue: any): void;
+    onSurveyLoad(): void;
     initSignaturePad(el: HTMLElement): void;
     destroySignaturePad(el: HTMLElement): void;
     /**

package/typings/settings.d.ts

@@ -151,6 +151,7 @@ export declare var settings: {
      * const item = new ItemValue("item1");
      * const itemString = item.toJSON(); // Produces { value: "item1", text: "item1" } instead of "item1"
      * ```
+     * @see [settings.parseNumber](https://surveyjs.io/form-library/documentation/api-reference/settings#parseNumber)
      */
     serialization: {
         itemValueSerializeAsObject: boolean;
@@ -618,4 +619,28 @@ export declare var settings: {
      * ```
      */
     storeUtcDates: boolean;
+    /**
+     * A function that allows you to define custom parsing rules for numbers represented as string values.
+     *
+     * The following code shows a template that you can use to implement the `parseNumber` function:
+     *
+     * ```js
+     * import { settings } from "survey-core";
+     *
+     * settings.parseNumber = (stringValue, numericValue) => {
+     *   if (typeof stringValue !== "string" || !stringValue)
+     *     return numericValue;
+     *   let parsedNumber = numericValue;
+     *   // ...
+     *   // Parsing the number according to custom parsing rules
+     *   // ...
+     *   return parsedNumber;
+     * };
+     * ```
+     * @param stringValue A number represented as a string value.
+     * @param numericValue A number parsed using a default parsing function. `NaN` if the original string is not a number.
+     * @returns A number that results from parsing the string value.
+     * @see [settings.serialization](https://surveyjs.io/form-library/documentation/api-reference/settings#serialization)
+     */
+    parseNumber: (stringValue: any, numericValue: number) => number;
 };