survey-react 1.9.117 → 1.9.119

package/survey.react.d.ts

@@ -82,6 +82,7 @@ declare module "localization/english" {
         urlRequestError: string;
         urlGetChoicesError: string;
         exceedMaxSize: string;
+        noUploadFilesHandler: string;
         otherRequiredError: string;
         uploadingFile: string;
         loadingFile: string;
@@ -201,6 +202,7 @@ declare module "surveyStrings" {
         urlRequestError: string;
         urlGetChoicesError: string;
         exceedMaxSize: string;
+        noUploadFilesHandler: string;
         otherRequiredError: string;
         uploadingFile: string;
         loadingFile: string;
@@ -463,6 +465,7 @@ declare module "jsonobject" {
         minValue: any;
         private dataListValue;
         layout: string;
+        onSerializeValue: (obj: any) => any;
         onGetValue: (obj: any) => any;
         onSettingValue: (obj: any, value: any) => any;
         onSetValue: (obj: any, value: any, jsonConv: JsonObject) => any;
@@ -487,6 +490,7 @@ declare module "jsonobject" {
         set defaultValue(newValue: any);
         isDefaultValue(value: any): boolean;
         isDefaultValueByObj(obj: Base, value: any): boolean;
+        getSerializableValue(obj: any): any;
         getValue(obj: any): any;
         getPropertyValue(obj: any): any;
         get hasToUseSetValue(): string | ((obj: any, value: any, jsonConv: JsonObject) => any);
@@ -700,6 +704,7 @@ declare module "conditionProcessValue" {
         private getValueFromSurvey;
         private getValueFromValues;
         private getNonNestedObject;
+        private getNonNestedObjectCore;
         private getObjInArray;
         private getFirstPropertyName;
         private getObjectValue;
@@ -1758,6 +1763,7 @@ declare module "defaultCss/defaultV2Css" {
             invisible: string;
             navigationButton: string;
             compact: string;
+            errorsContainer: string;
         };
         paneldynamic: {
             mainRoot: string;
@@ -1824,6 +1830,7 @@ declare module "defaultCss/defaultV2Css" {
             emptyHeaderRoot: string;
             title: string;
             description: string;
+            errorsContainer: string;
         };
         pageTitle: string;
         pageDescription: string;
@@ -1878,6 +1885,9 @@ declare module "defaultCss/defaultV2Css" {
             invisible: string;
             composite: string;
             disabled: string;
+            errorsContainer: string;
+            errorsContainerTop: string;
+            errorsContainerBottom: string;
         };
         image: {
             mainRoot: string;
@@ -1897,9 +1907,6 @@ declare module "defaultCss/defaultV2Css" {
             root: string;
             icon: string;
             item: string;
-            outsideQuestion: string;
-            aboveQuestion: string;
-            belowQuestion: string;
             locationTop: string;
             locationBottom: string;
         };
@@ -2117,6 +2124,8 @@ declare module "defaultCss/defaultV2Css" {
             rowHasEndActions: string;
             headerCell: string;
             rowTextCell: string;
+            footerCell: string;
+            footerTotalCell: string;
             columnTitleCell: string;
             cellRequiredText: string;
             detailButton: string;
@@ -2152,6 +2161,7 @@ declare module "defaultCss/defaultV2Css" {
             itemCell: string;
             headerCell: string;
             rowTextCell: string;
+            footerCell: string;
             columnTitleCell: string;
             cellRequiredText: string;
             button: string;
@@ -2300,6 +2310,7 @@ declare module "defaultCss/defaultV2Css" {
         };
         saveData: {
             root: string;
+            rootWithButtons: string;
             info: string;
             error: string;
             success: string;
@@ -3577,6 +3588,8 @@ declare module "panel" {
         set questionErrorLocation(val: string);
         getQuestionErrorLocation(): string;
         get no(): string;
+        get cssError(): string;
+        protected getCssError(cssClasses: any): string;
         dispose(): void;
     }
     /**
@@ -3657,6 +3670,7 @@ declare module "panel" {
          */
         get no(): string;
         protected setNo(visibleIndex: number): void;
+        protected notifyStateChanged(): void;
         protected createLocTitleProperty(): LocalizableString;
         protected beforeSetVisibleIndex(index: number): number;
         protected getPanelStartIndex(index: number): number;
@@ -3689,7 +3703,6 @@ declare module "panel" {
         get hasEditButton(): boolean;
         cancelPreview(): void;
         get cssTitle(): string;
-        get cssError(): string;
         get showErrorsAbovePanel(): boolean;
         protected getCssError(cssClasses: any): string;
         protected onVisibleChanged(): void;
@@ -3697,6 +3710,7 @@ declare module "panel" {
         focusIn(): void;
         protected getHasFrameV2(): boolean;
         protected getIsNested(): boolean;
+        private get showPanelAsPage();
         protected getCssRoot(cssClasses: {
             [index: string]: string;
         }): string;
@@ -3885,7 +3899,9 @@ declare module "question_file" {
         confirmRemoveAllMessage: string;
         noFileChosenCaption: string;
         chooseButtonCaption: string;
-        takePhotoCaption: string;
+        get takePhotoCaption(): string;
+        set takePhotoCaption(val: string);
+        get locTakePhotoCaption(): LocalizableString;
         replaceButtonCaption: string;
         clearButtonCaption: string;
         removeFileCaption: string;
@@ -4235,6 +4251,7 @@ declare module "question_baseselect" {
          * When users select the "None" item in multi-select questions, all other items become unselected.
          * @see noneItem
          * @see noneText
+         * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
          */
         get showNoneItem(): boolean;
         set showNoneItem(val: boolean);
@@ -4339,6 +4356,7 @@ declare module "question_baseselect" {
          *
          * [View Demo](https://surveyjs.io/form-library/examples/questiontype-dropdownrestfull/ (linkStyle))
          * @see choices
+         * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
          */
         get choicesByUrl(): ChoicesRestful;
         set choicesByUrl(val: ChoicesRestful);
@@ -4361,6 +4379,7 @@ declare module "question_baseselect" {
          * If you need to specify only the `value` property, you can set the `choices` property to an array of primitive values, for example, `[ "item1", "item2", "item3" ]`. These values are both saved in survey results and used as display text.
          * @see choicesByUrl
          * @see choicesFromQuestion
+         * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
          */
         get choices(): Array<any>;
         set choices(newValue: Array<any>);
@@ -4432,6 +4451,7 @@ declare module "question_baseselect" {
          * - `"asc"`- Sorts choice items in ascending order.
          * - `"desc"`- Sorts choice items in ascending order.
          * - `"random"` - Displays choice items in random order.
+         * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
          */
         get choicesOrder(): string;
         set choicesOrder(val: string);
@@ -4446,6 +4466,7 @@ declare module "question_baseselect" {
          * Displays the "Select All", "None", and "Other" choices on individual rows.
          * @see showNoneItem
          * @see showOtherItem
+         * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
          */
         separateSpecialChoices: boolean;
         /**
@@ -4534,7 +4555,6 @@ declare module "question_baseselect" {
         protected getCommentFromValue(newValue: any): string;
         protected setOtherValueIntoValue(newValue: any): any;
         onOtherValueInput(event: any): void;
-        onCompositionUpdateOtherValue(event: any): void;
         onOtherValueChange(event: any): void;
         private isRunningChoices;
         private runChoicesByUrl;
@@ -4925,6 +4945,7 @@ declare module "question_matrixdropdowncolumn" {
         getCellType(): string;
         getCustomCellType(column: MatrixDropdownColumn, row: MatrixDropdownRowModelBase, cellType: string): string;
         onColumnCellTypeChanged(column: MatrixDropdownColumn): void;
+        getCellAriaLabel(rowTitle: string, columnTitle: string): string;
     }
     export var matrixDropdownColumnTypes: any;
     export class MatrixDropdownColumn extends Base implements ILocalizableOwner, IWrapperObject {
@@ -5378,6 +5399,9 @@ declare module "question_matrixdynamic" {
         private dragOrClickHelper;
         constructor(index: number, data: IMatrixDropdownData, value: any);
         get rowName(): string;
+        get dataName(): string;
+        get text(): any;
+        getAccessbilityText(): string;
         get shortcutText(): string;
     }
     /**
@@ -5719,9 +5743,9 @@ declare module "themes" {
          *
          * Possible values:
          *
-         * - `"survey"` (default)\
+         * - `"survey"`\
          * The header width is the same as the survey width.
-         * - `"container"`\
+         * - `"container"` (default)\
          * The header width is the same as the survey container width.
          *
          * @see [SurveyModel.width](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#width)
@@ -6458,7 +6482,7 @@ declare module "question_paneldynamic" {
 declare module "survey-events-api" {
     import { IAction } from "actions/action";
     import { Base } from "base";
-    import { IElement, ISurveyElement, IValueItemCustomPropValues } from "base-interfaces";
+    import { IElement, IPanel, ISurveyElement, IValueItemCustomPropValues } from "base-interfaces";
     import { ItemValue } from "itemvalue";
     import { PageModel } from "page";
     import { PanelModel, PanelModelBase } from "panel";
@@ -6957,9 +6981,9 @@ declare module "survey-events-api" {
     }
     export interface UploadFilesEvent extends LoadFilesEvent {
         /**
-         * A callback function that you should call when a file is uploaded successfully or when file upload fails. Pass `"success"` or `"error"` as the first argument to indicate the operation status. As the second argument, you can pass the uploaded file's data if file upload was successful or an error message if file upload failed.
+         * A callback function that you should call when a file is uploaded successfully or when file upload fails. Pass an array of successfully uploaded files as the first argument. As the second argument, you can pass an array of error messages if file upload failed.
          */
-        callback: (status: string, data?: any) => any;
+        callback: (data: any | Array<any>, errors?: any | Array<any>) => any;
         /**
          * An array of JavaScript <a href="https://developer.mozilla.org/en-US/docs/Web/API/File" target="_blank">File</a> objects that represent files to upload.
          */
@@ -7316,27 +7340,39 @@ declare module "survey-events-api" {
         /**
          * A survey element being dragged.
          */
-        target: IElement;
+        draggedElement: IElement;
         /**
-         * A survey element from which `target` is being dragged. This parameter is `null` if `target` is being dragged from the [Toolbox](https://surveyjs.io/survey-creator/documentation/toolbox).
+         * A survey element from which `draggedElement` is being dragged. This parameter is `null` if `draggedElement` is being dragged from the [Toolbox](https://surveyjs.io/survey-creator/documentation/toolbox).
          */
-        source: IElement;
+        fromElement: IPanel;
+        /**
+         * A survey element to which `draggedElement` is being dragged.
+         */
+        toElement: IElement;
         /**
          * A survey element before which the target element will be placed. This parameter is `null` if the parent container (page or panel) has no elements or if the target element will be placed below all other elements within the container.
          */
         insertBefore: IElement;
         /**
-         * A survey element after which `target` will be placed. This parameter is `null` if the parent container (page or panel) has no elements or if `target` will be placed above all other elements within the container.
+         * A survey element after which `draggedElement` will be placed. This parameter is `null` if the parent container (page or panel) has no elements or if `draggedElement` will be placed above all other elements within the container.
          */
         insertAfter: IElement;
         /**
-         * A parent container (page or panel) within which `target` will be placed.
+         * A parent container (page or panel) within which `draggedElement` will be placed.
          */
         parent: ISurveyElement;
         /**
          * A Boolean property that you can set to `false` if you want to cancel the drag and drop operation.
          */
         allow: boolean;
+        /**
+         * Obsolete. Use `options.draggedElement` instead.
+         */
+        target: IElement;
+        /**
+         * Obsolete. Use `options.toElement` instead.
+         */
+        source: IElement;
     }
     export interface ScrollingElementToTopEvent {
         /**
@@ -7496,6 +7532,7 @@ declare module "page" {
         protected calcCssClasses(css: any): any;
         get cssTitle(): string;
         get cssRoot(): string;
+        protected getCssError(cssClasses: any): string;
         num: number;
         /**
          * Set this property to "hide" to make "Prev", "Next" and "Complete" buttons are invisible for this page. Set this property to "show" to make these buttons visible, even if survey showNavigationButtons property is false.
@@ -7757,6 +7794,15 @@ declare module "notifier" {
     import { Base } from "base";
     import { ActionContainer } from "actions/container";
     import { IAction } from "actions/action";
+    interface INotifierCssClasses {
+        root: string;
+        rootWithButtons: string;
+        info: string;
+        error: string;
+        success: string;
+        button: string;
+        shown: string;
+    }
     export class Notifier extends Base {
         private cssClasses;
         active: boolean;
@@ -7768,14 +7814,7 @@ declare module "notifier" {
         private actionsVisibility;
         actionBar: ActionContainer;
         showActions: boolean;
-        constructor(cssClasses: {
-            root: string;
-            info: string;
-            error: string;
-            success: string;
-            button: string;
-            shown: string;
-        });
+        constructor(cssClasses: INotifierCssClasses);
         getCssClass(type: string): string;
         updateActionsVisibility(type: string): void;
         notify(message: string, type?: string, waitUserAction?: boolean): void;
@@ -7843,11 +7882,10 @@ declare module "question_textbase" {
         protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
         protected convertToCorrectValue(val: any): any;
         protected getValueSeparator(): string;
-        disableNativeUndoRedo: boolean;
-        protected checkForUndo(event: KeyboardEvent): void;
         protected getControlCssClassBuilder(): CssClassBuilder;
         getControlClass(): string;
         get isNewA11yStructure(): boolean;
+        onKeyDownPreprocess: (event: any) => void;
     }
 }
 declare module "question_text" {
@@ -8372,6 +8410,7 @@ declare module "survey" {
     import { QuestionMultipleTextModel } from "question_multipletext";
     import { ITheme, ImageFit, ImageAttachment } from "themes";
     import { PopupModel } from "popup";
+    import { Cover } from "header";
     /**
      * The `SurveyModel` object contains properties and methods that allow you to control the survey and access its elements.
      *
@@ -9097,8 +9136,11 @@ declare module "survey" {
          *
          * - `"advanced"`\
          * An advanced header view applies the same properties as the basic view, plus [header settings](https://surveyjs.io/form-library/documentation/api-reference/iheader) from the [survey theme](https://surveyjs.io/form-library/documentation/api-reference/itheme#header). The advanced view features a more flexible header layout, a capability to specify a background image, and other settings that give a more professional look to the survey header.
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/brand-your-survey-header/ (linkStyle))
          */
         headerView: "advanced" | "basic";
+        protected insertAdvancedHeader(advHeader: Cover): void;
         private getNavigationCss;
         private lazyRenderingValue;
         showBrandInfo: boolean;
@@ -9294,7 +9336,8 @@ declare module "survey" {
          * Specifies whether to hide validation errors thrown by the Required validation in the UI.
          *
          * [Built-In Client-Side Validators](https://surveyjs.io/form-library/documentation/data-validation#built-in-client-side-validators (linkStyle))
-         * @see ignoreValidation
+         * @see validationEnabled
+         * @see validationAllowSwitchPages
          */
         hideRequiredErrors: boolean;
         beforeSettingQuestionErrors(question: Question, errors: Array<SurveyError>): void;
@@ -9367,6 +9410,10 @@ declare module "survey" {
          * - `"onComplete"` - Triggers validation when a user clicks the Complete button. If previous pages contain errors, the survey switches to the page with the first error.
          *
          * Refer to the following help topic for more information: [Data Validation](https://surveyjs.io/form-library/documentation/data-validation).
+         * @see validationEnabled
+         * @see validationAllowSwitchPages
+         * @see validationAllowComplete
+         * @see validate
          */
         get checkErrorsMode(): string;
         set checkErrorsMode(val: string);
@@ -10026,6 +10073,16 @@ declare module "survey" {
         get completedState(): string;
         get completedStateText(): string;
         protected setCompletedState(value: string, text: string): void;
+        /**
+         * Displays a toast notification with a specified message.
+         *
+         * Depending on the `type` argument, a survey can display the following notification types:
+         *
+         * ![Toast notification types in SurveyJS Form Library](https://surveyjs.io//Content/Images/docs/notification-types.png)
+         * @param message A message to display.
+         * @param type A notification type: `"info"` (default), `"success"`, or `"error"`.
+         * @param showActions For internal use.
+         */
         notify(message: string, type: string, showActions?: boolean): void;
         /**
          * Resets the survey [`state`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#state) and, optionally, [`data`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#data). If `state` is `"completed"`, it becomes `"running"`.
@@ -10091,15 +10148,32 @@ declare module "survey" {
          */
         deleteCookie(): void;
         /**
-         * Specifies whether to skip validation when you switch between pages or complete the survey programmatically or when users do that in the UI.
+         * This property is obsolete. Use the [`validationEnabled`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#validationEnabled) property instead.
+         */
+        get ignoreValidation(): boolean;
+        set ignoreValidation(val: boolean);
+        /**
+         * Specifies whether data validation is enabled.
          *
-         * Default value: `false`
+         * Default value: `true`
+         * @see checkErrorsMode
          * @see hideRequiredErrors
-         * @see nextPage
-         * @see isPrevPage
-         * @see completeLastPage
          */
-        ignoreValidation: boolean;
+        validationEnabled: boolean;
+        /**
+         * Specifies whether respondents can switch the current page even if it contains validation errors.
+         *
+         * Default value: `false`
+         * @see checkErrorsMode
+         */
+        validationAllowSwitchPages: boolean;
+        /**
+         * Specifies whether respondents can end a survey with validation errors.
+         *
+         * Default value: `false`
+         * @see checkErrorsMode
+         */
+        validationAllowComplete: boolean;
         /**
          * Switches the survey to the next page.
          *
@@ -10252,7 +10326,7 @@ declare module "survey" {
         private runningPages;
         private onShowingPreviewChanged;
         private changeCurrentPageFromPreview;
-        private origionalPages;
+        private originalPages;
         protected onQuestionsOnPageModeChanged(oldValue: string): void;
         private restoreOriginalPages;
         private getPageStartIndex;
@@ -10447,11 +10521,11 @@ declare module "survey" {
          * @param question A [File Upload question instance](https://surveyjs.io/form-library/documentation/api-reference/file-model).
          * @param name The File Upload question's [`name`](https://surveyjs.io/form-library/documentation/api-reference/file-model#name).
          * @param files An array of JavaScript <a href="https://developer.mozilla.org/en-US/docs/Web/API/File" target="_blank">File</a> objects that represent files to upload.
-         * @param callback A callback function that allows you to get the upload status (`"success"` or `"error"`) and file data.
+         * @param callback A callback function that allows you to access successfully uploaded files as the first argument. If any files fail to upload, the second argument contains an array of error messages.
          * @see onUploadFiles
          * @see downloadFile
          */
-        uploadFiles(question: QuestionFileModel, name: string, files: File[], callback: (status: string, data: any) => any): void;
+        uploadFiles(question: QuestionFileModel, name: string, files: File[], callback: (data: any | Array<any>, errors?: any | Array<any>) => any): void;
         /**
          * Downloads a file from a server.
          *
@@ -10487,7 +10561,7 @@ declare module "survey" {
         updateChoicesFromServer(question: QuestionSelectBase, choices: Array<ItemValue>, serverResult: any): Array<ItemValue>;
         loadedChoicesFromServer(question: IQuestion): void;
         protected createSurveyService(): dxSurveyService;
-        protected uploadFilesCore(name: string, files: File[], uploadingCallback: (status: string, data: any) => any): void;
+        protected uploadFilesCore(name: string, files: File[], uploadingCallback: (data: any | Array<any>, errors?: any | Array<any>) => any): void;
         getPage(index: number): PageModel;
         /**
          * Adds an existing page to the survey.
@@ -10990,6 +11064,7 @@ declare module "survey" {
         private isMovingQuestion;
         startMovingQuestion(): void;
         stopMovingQuestion(): void;
+        get isQuestionDragging(): boolean;
         private needRenderIcons;
         private skippedPages;
         /**
@@ -11874,7 +11949,6 @@ declare module "question" {
         get isContainer(): boolean;
         protected updateCommentElements(): void;
         onCommentInput(event: any): void;
-        onCompositionUpdateComment(event: any): void;
         onCommentChange(event: any): void;
         afterRenderQuestionElement(el: HTMLElement): void;
         afterRender(el: HTMLElement): void;
@@ -11989,6 +12063,7 @@ declare module "question" {
          * @see otherItem
          * @see otherErrorText
          * @see showCommentArea
+         * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
          */
         get showOtherItem(): boolean;
         set showOtherItem(val: boolean);
@@ -12141,6 +12216,8 @@ declare module "question" {
          * - `{row.other_question_name}` (to access questions inside the same dynamic matrix or multi-column dropdown)
          *
          * An expression can also include built-in and custom functions for advanced calculations. For example, if the `defaultValue` should be today's date, set the `defaultValueExpression` to `"today()"`, and the corresponding built-in function will be executed each time the survey is loaded. Refer to the following help topic for more information: [Built-In Functions](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#built-in-functions).
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/specify-default-question-value-dynamically (linkStyle))
          * @see defaultValue
          * @see setValueExpression
          */
@@ -12511,6 +12588,7 @@ declare module "martixBase" {
         get rowTitleWidth(): string;
         set rowTitleWidth(val: string);
         getCellAriaLabel(rowTitle: string, columnTitle: string): string;
+        get isNewA11yStructure(): boolean;
     }
 }
 declare module "question_matrixdropdownbase" {
@@ -12557,6 +12635,7 @@ declare module "question_matrixdropdownbase" {
         data: IMatrixDropdownData;
         private questionValue;
         constructor(column: MatrixDropdownColumn, row: MatrixDropdownRowModelBase, data: IMatrixDropdownData);
+        private updateCellQuestionTitleDueToAccessebility;
         locStrsChanged(): void;
         protected createQuestion(column: MatrixDropdownColumn, row: MatrixDropdownRowModelBase, data: IMatrixDropdownData): Question;
         get question(): Question;
@@ -12592,10 +12671,12 @@ declare module "question_matrixdropdownbase" {
         constructor(data: IMatrixDropdownData, value: any);
         get id(): string;
         get rowName(): any;
+        get dataName(): string;
         get text(): any;
         get value(): any;
         set value(value: any);
         get locText(): LocalizableString;
+        getAccessbilityText(): string;
         get hasPanel(): boolean;
         get detailPanel(): PanelModel;
         get detailPanelId(): string;
@@ -13127,7 +13208,7 @@ declare module "base-interfaces" {
         maxTextLength: number;
         maxOthersLength: number;
         clearValueOnDisableItems: boolean;
-        uploadFiles(question: IQuestion, name: string, files: File[], uploadingCallback: (status: string, data: any) => any): any;
+        uploadFiles(question: IQuestion, name: string, files: File[], uploadingCallback: (data: any | Array<any>, errors?: any | Array<any>) => any): any;
         downloadFile(question: IQuestion, name: string, content: string, callback: (status: string, data: any) => any): any;
         clearFiles(question: IQuestion, name: string, value: any, fileName: string, clearCallback: (status: string, data: any) => any): any;
         updateChoicesFromServer(question: IQuestion, choices: Array<any>, serverResult: any): Array<any>;
@@ -13321,6 +13402,7 @@ declare module "base-interfaces" {
         component?: string;
         template?: string;
         data?: any;
+        index?: number;
         processResponsiveness?: (width: number) => void;
     }
     export interface IPlainDataOptions {
@@ -14323,6 +14405,27 @@ declare module "settings" {
          * Default value: `"none"`
          */
         noneItemValue: string;
+        /**
+         * An object whose properties specify the order of the special choice items (None, Other, Select All) in select-based questions.
+         *
+         * Default value: `{ selectAllItem: [-1], noneItem: [1], otherItem: [2] }`
+         *
+         * Use this object to reorder special choices. Each property accepts an array of integer numbers. Negative numbers place a special choice item above regular choice items, positive numbers place it below them. For instance, the code below specifies the following order of choices: None, Select All, regular choices, Other.
+         *
+         * ```js
+         * import { settings } from "survey-core";
+         *
+         * settings.specialChoicesOrder.noneItem = [-2];
+         * settings.specialChoicesOrder.selectAllItem = [-1];
+         * settings.specialChoicesOrder.otherItem = [1];
+         * ```
+         *
+         * If you want to duplicate a special choice item above and below other choices, add two numbers to the corresponding array:
+         *
+         * ```js
+         * settings.specialChoicesOrder.selectAllItem = [-1, 3] // Displays Select All above and below other choices
+         * ```
+         */
         specialChoicesOrder: {
             selectAllItem: number[];
             noneItem: number[];
@@ -15314,6 +15417,7 @@ declare module "dragdrop/choices" {
     import { QuestionSelectBase } from "question_baseselect";
     import { DragDropCore } from "dragdrop/core";
     export class DragDropChoices extends DragDropCore<QuestionSelectBase> {
+        private imagepickerControlsNode;
         protected get draggedElementType(): string;
         protected createDraggedElementShortcut(text: string, draggedElementNode: HTMLElement, event: PointerEvent): HTMLElement;
         private createImagePickerShortcut;
@@ -15468,7 +15572,13 @@ declare module "question_ranking" {
         set selectToRankAreasLayout(val: string);
         get renderedSelectToRankAreasLayout(): string;
         isMobileMode(): boolean;
+        /**
+         * A placeholder displayed in the area for ranked choices. Applies when [`selectToRankEnabled`](https://surveyjs.io/form-library/documentation/api-reference/ranking-question-model#selectToRankEnabled) is `true`.
+         */
         selectToRankEmptyRankedAreaText: string;
+        /**
+         * A placeholder displayed in the area for unranked choices. Applies when [`selectToRankEnabled`](https://surveyjs.io/form-library/documentation/api-reference/ranking-question-model#selectToRankEnabled) is `true`.
+         */
         selectToRankEmptyUnrankedAreaText: string;
         get useFullItemSizeForShortcut(): boolean;
         set useFullItemSizeForShortcut(val: boolean);
@@ -15718,6 +15828,7 @@ declare module "question_rating" {
         itemValuePropertyChanged(item: ItemValue, name: string, oldValue: any, newValue: any): void;
         private createRenderedRateItems;
         renderedRateItems: Array<RenderedRatingItem>;
+        private createRateValues;
         private correctValue;
         getType(): string;
         protected getFirstInputElementId(): string;
@@ -16106,7 +16217,9 @@ declare module "question_signaturepad" {
          *
          * Default value: `false`
          *
-         * > The signature area is scaled only for display. The resulting image will have dimensions specified by the [`signatureHeight`](#signatureHeight) and [`signatureWidth`](#signatureWidth) properties.
+         * This property auto-scales the signature area to fill all available width within the question box while maintaining the default 3:2 aspect ratio. If you set [custom width](#signatureWidth) and [height](#signatureHeight) values, the setting will keep the aspect ratio of these dimensions.
+         *
+         * > The signature area is scaled only for display. The image saved in survey results will have dimensions specified by the [`signatureHeight`](#signatureHeight) and [`signatureWidth`](#signatureWidth) properties.
          */
         signatureAutoScaleEnabled: boolean;
         /**
@@ -16898,6 +17011,7 @@ declare module "defaultCss/cssstandard" {
         };
         saveData: {
             root: string;
+            rootWithButtons: string;
             info: string;
             error: string;
             success: string;
@@ -17362,6 +17476,7 @@ declare module "defaultCss/cssmodern" {
         };
         saveData: {
             root: string;
+            rootWithButtons: string;
             info: string;
             error: string;
             success: string;
@@ -23651,11 +23766,13 @@ declare module "react/reactquestion_comment" {
         protected renderElement(): JSX.Element;
     }
     export class SurveyQuestionCommentItem extends ReactSurveyElement {
+        private getStateComment;
+        constructor(props: any);
         protected canRender(): boolean;
         protected onCommentChange(event: any): void;
         protected onCommentInput(event: any): void;
-        protected onCommentCompositionUpdate(event: any): void;
         protected getComment(): string;
+        protected setComment(value: any): void;
         protected getId(): string;
         protected getPlaceholder(): string;
         protected renderElement(): JSX.Element;
@@ -23663,8 +23780,8 @@ declare module "react/reactquestion_comment" {
     export class SurveyQuestionOtherValueItem extends SurveyQuestionCommentItem {
         protected onCommentChange(event: any): void;
         protected onCommentInput(event: any): void;
-        protected onCommentCompositionUpdate(event: any): void;
         protected getComment(): string;
+        protected setComment(value: any): void;
         protected getId(): string;
         protected getPlaceholder(): string;
     }
@@ -24313,6 +24430,18 @@ declare module "react/components/rating/rating-item-smiley" {
         render(): JSX.Element | null;
     }
 }
+declare module "react/components/rating/rating-dropdown-item" {
+    import { SurveyElementBase } from "react/reactquestion_element";
+    interface IRatingItemProps {
+        item: any;
+    }
+    export class RatingDropdownItem extends SurveyElementBase<IRatingItemProps, any> {
+        get item(): any;
+        getStateElement(): any;
+        render(): JSX.Element | null;
+        renderDescription(item: any): JSX.Element;
+    }
+}
 declare module "react/tagbox-filter" {
     import { DropdownMultiSelectListModel, QuestionTagboxModel } from "entries/core";
     import { SurveyElementBase } from "react/reactquestion_element";
@@ -24842,6 +24971,7 @@ declare module "react/reactquestion_rating" {
 declare module "react/rating-dropdown" {
     import { QuestionRatingModel } from "entries/core";
     import { SurveyQuestionDropdownBase } from "react/dropdown-base";
+    export * from "react/components/rating/rating-dropdown-item";
     export class SurveyQuestionRatingDropdown extends SurveyQuestionDropdownBase<QuestionRatingModel> {
         constructor(props: any);
         protected renderElement(): JSX.Element;
@@ -25066,6 +25196,7 @@ declare module "entries/react-ui-model" {
     export { RatingItem } from "react/components/rating/rating-item";
     export { RatingItemStar } from "react/components/rating/rating-item-star";
     export { RatingItemSmiley } from "react/components/rating/rating-item-smiley";
+    export { RatingDropdownItem } from "react/components/rating/rating-dropdown-item";
     export { TagboxFilterString } from "react/tagbox-filter";
     export { SurveyQuestionOptionItem } from "react/dropdown-item";
     export { SurveyQuestionDropdownBase } from "react/dropdown-base";