survey-core 1.9.116 → 1.9.118

package/typings/question_matrixdropdownbase.d.ts

@@ -41,6 +41,7 @@ export declare class MatrixDropdownCell {
     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;
@@ -76,10 +77,12 @@ export declare class MatrixDropdownRowModelBase implements ISurveyData, ISurveyI
     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;

package/typings/question_matrixdropdowncolumn.d.ts

@@ -15,6 +15,7 @@ export interface IMatrixColumnOwner extends ILocalizableOwner {
     getCellType(): string;
     getCustomCellType(column: MatrixDropdownColumn, row: MatrixDropdownRowModelBase, cellType: string): string;
     onColumnCellTypeChanged(column: MatrixDropdownColumn): void;
+    getCellAriaLabel(rowTitle: string, columnTitle: string): string;
 }
 export declare var matrixDropdownColumnTypes: any;
 export declare class MatrixDropdownColumn extends Base implements ILocalizableOwner, IWrapperObject {

package/typings/question_matrixdynamic.d.ts

@@ -10,6 +10,9 @@ export declare class MatrixDynamicRowModel extends MatrixDropdownRowModelBase im
     private dragOrClickHelper;
     constructor(index: number, data: IMatrixDropdownData, value: any);
     get rowName(): string;
+    get dataName(): string;
+    get text(): any;
+    getAccessbilityText(): string;
     get shortcutText(): string;
 }
 /**

package/typings/question_signaturepad.d.ts

@@ -51,7 +51,9 @@ export declare class QuestionSignaturePadModel extends Question {
      *
      * 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;
     /**

package/typings/question_textbase.d.ts

@@ -58,9 +58,8 @@ export declare class QuestionTextBase extends Question {
     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;
 }

package/typings/settings.d.ts

@@ -485,6 +485,32 @@ export declare var 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[];
+        otherItem: number[];
+    };
     /**
      * A list of supported validators by question type.
      */

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

@@ -1,6 +1,6 @@
 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";
@@ -509,7 +509,7 @@ export interface UploadFilesEvent extends LoadFilesEvent {
 }
 export interface DownloadFileEvent extends LoadFilesEvent {
     /**
-     * A callback function that you should call when a file is downloaded successfully or when deletion fails. Pass `"success"` or `"error"` as the first argument to indicate the operation status. As the second argument, you can pass the downloaded file's data as a Base64 string if file upload was successful or an error message if file upload failed.
+     * A callback function that you should call when a file is downloaded successfully or when deletion fails. Pass `"success"` or `"error"` as the first argument to indicate the operation status. As the second argument, you can pass the downloaded file's data as a Base64 string if file download was successful or an error message if file download failed.
      */
     callback: (status: string, data?: any) => any;
     /**
@@ -523,7 +523,7 @@ export interface DownloadFileEvent extends LoadFilesEvent {
 }
 export interface ClearFilesEvent extends LoadFilesEvent {
     /**
-     * A callback function that you should call when files are deleted successfully or when deletion fails. Pass `"success"` or `"error"` as the first argument to indicate the operation status. As the second argument, you can pass deleted files' data (`options.value`) if file upload was successful or an error message if file upload failed.
+     * A callback function that you should call when files are deleted successfully or when deletion fails. Pass `"success"` or `"error"` as the first argument to indicate the operation status. As the second argument, you can pass deleted files' data (`options.value`) if file deletion was successful or an error message if file deletion failed.
      */
     callback: (status: string, data?: any) => any;
     /**
@@ -858,27 +858,39 @@ export interface DragDropAllowEvent {
     /**
      * 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 {
     /**

package/typings/survey.d.ts

@@ -750,6 +750,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *
      * - `"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";
     private getNavigationCss;
@@ -1679,6 +1681,16 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     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"`.
@@ -1905,9 +1917,9 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private runningPages;
     private onShowingPreviewChanged;
     private changeCurrentPageFromPreview;
-    private origionalPages;
+    private originalPages;
     protected onQuestionsOnPageModeChanged(oldValue: string): void;
-    private restoreOrigionalPages;
+    private restoreOriginalPages;
     private getPageStartIndex;
     private setupPagesForPageModes;
     private createPagesForQuestionOnPageMode;