survey-react 1.9.81 → 1.9.82

package/survey.react.js

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - Survey JavaScript library v1.9.81
+ * surveyjs - Survey JavaScript library v1.9.82
  * Copyright (c) 2015-2023 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */
@@ -2859,6 +2859,8 @@ var Base = /** @class */ (function () {
             this.localizableStrings = {};
         }
         this.localizableStrings[name] = locStr;
+        var prop = this.getPropertyByName(name);
+        locStr.disableLocalization = prop && prop.isLocalizable === false;
         return locStr;
     };
     Base.prototype.getLocalizableString = function (name) {
@@ -5456,6 +5458,7 @@ var defaultStandardCss = {
     rating: {
         root: "sv_q_rating",
         item: "sv_q_rating_item",
+        itemFixedSize: "sv_q_rating_item_fixed",
         selected: "active",
         minText: "sv_q_rating_min_text",
         itemText: "sv_q_rating_item_text",
@@ -6017,6 +6020,7 @@ var defaultV2Css = {
         itemText: "sd-rating__item-text",
         maxText: "sd-rating__item-text sd-rating__max-text",
         itemDisabled: "sd-rating__item--disabled",
+        itemFixedSize: "sd-rating__item--fixed-size",
         control: "sd-input sd-dropdown",
         controlValue: "sd-dropdown__value",
         controlDisabled: "sd-input--disabled",
@@ -8175,6 +8179,9 @@ var DropdownListModel = /** @class */ (function (_super) {
         this.listModel.resetFocusedItem();
         if (this.question.selectedItem && this.question.selectedItem.text.indexOf(newValue) >= 0) {
             this.listModel.focusedItem = this.getAvailableItems().filter(function (item) { return item.id == _this.question.selectedItem.value; })[0];
+            if (this.listModel.filterString) {
+                this.listModel.actions.map(function (a) { return a.selectedValue = false; });
+            }
             return;
         }
         if (!this.listModel.focusedItem || !this.listModel.isItemVisible(this.listModel.focusedItem)) {
@@ -8189,6 +8196,7 @@ var DropdownListModel = /** @class */ (function (_super) {
     };
     DropdownListModel.prototype.onHidePopup = function () {
         this.resetFilterString();
+        this.question.suggestedItem = null;
         this.listModel.refresh();
     };
     DropdownListModel.prototype.getAvailableItems = function () {
@@ -8331,7 +8339,8 @@ var DropdownListModel = /** @class */ (function (_super) {
     });
     Object.defineProperty(DropdownListModel.prototype, "showHintString", {
         get: function () {
-            return !!this.question.searchEnabled && this.hintStringLC && this.hintStringLC.indexOf(this.inputStringLC) >= 0;
+            return !!this.question.searchEnabled && this.hintStringLC && this.hintStringLC.indexOf(this.inputStringLC) >= 0 ||
+                !this.question.searchEnabled && this.hintStringLC && !this.question.value;
         },
         enumerable: false,
         configurable: true
@@ -8381,6 +8390,8 @@ var DropdownListModel = /** @class */ (function (_super) {
     };
     DropdownListModel.prototype.onClick = function (event) {
         this._popupModel.toggleVisibility();
+        if (this._popupModel.isVisible && this.question.value && this.question instanceof _question_dropdown__WEBPACK_IMPORTED_MODULE_4__["QuestionDropdownModel"])
+            this.changeSelectionWithKeyboard(false);
         if (this.searchEnabled && !!event && !!event.target) {
             var input = event.target.querySelector("input");
             if (!!input) {
@@ -8403,14 +8414,20 @@ var DropdownListModel = /** @class */ (function (_super) {
     };
     DropdownListModel.prototype.changeSelectionWithKeyboard = function (reverse) {
         var _a;
+        var focusedItem = this.listModel.focusedItem;
         if (reverse) {
             this.listModel.focusPrevVisibleItem();
         }
         else {
             this.listModel.focusNextVisibleItem();
         }
+        if (this.question.value && focusedItem && this.question instanceof _question_dropdown__WEBPACK_IMPORTED_MODULE_4__["QuestionDropdownModel"]) {
+            focusedItem.selectedValue = false;
+            this.listModel.focusedItem.selectedValue = !this.listModel.filterString;
+            this.question.suggestedItem = this.listModel.focusedItem;
+        }
         this.scrollToFocusedItem();
-        if (this.question.value && this.question.searchEnabled && this.question instanceof _question_dropdown__WEBPACK_IMPORTED_MODULE_4__["QuestionDropdownModel"]) {
+        if (this.question.value && !this.listModel.filterString && this.question.searchEnabled && this.question instanceof _question_dropdown__WEBPACK_IMPORTED_MODULE_4__["QuestionDropdownModel"]) {
             this.applyInputString(this.listModel.focusedItem);
         }
         else {
@@ -9515,7 +9532,7 @@ __webpack_require__.r(__webpack_exports__);
 // import "../../main.scss";
 //import "../../modern.scss";
 var Version;
-Version = "" + "1.9.81";
+Version = "" + "1.9.82";
 function checkLibraryVersion(ver, libraryName) {
     if (Version != ver) {
         var str = "survey-core has version '" + Version + "' and " + libraryName
@@ -20024,6 +20041,9 @@ var LocalizableString = /** @class */ (function () {
         return res;
     };
     LocalizableString.prototype.setLocaleText = function (loc, value) {
+        if (this.disableLocalization) {
+            loc = _settings__WEBPACK_IMPORTED_MODULE_2__["settings"].defaultLocaleName;
+        }
         if (!this.storeDefaultText && value == this.getLocaleTextWithDefault(loc)) {
             if (!!value || !!loc && loc !== this.defaultLoc)
                 return;
@@ -20031,7 +20051,7 @@ var LocalizableString = /** @class */ (function () {
             var oldValue_1 = this.getValue(dl);
             if (!!dl && !!oldValue_1) {
                 this.setValue(dl, value);
-                this.fireStrChanged(oldValue_1, value);
+                this.fireStrChanged(dl, oldValue_1);
             }
             return;
         }
@@ -20042,11 +20062,9 @@ var LocalizableString = /** @class */ (function () {
             !this.getValue(loc) &&
             value == this.getLocaleText(this.defaultLoc))
             return;
-        var curLoc = this.locale;
+        var curLoc = this.curLocale;
         if (!loc)
             loc = this.defaultLoc;
-        if (!curLoc)
-            curLoc = this.defaultLoc;
         var oldValue = this.onStrChanged && loc === curLoc ? this.pureText : undefined;
         delete this.htmlValues[loc];
         if (!value) {
@@ -20066,8 +20084,15 @@ var LocalizableString = /** @class */ (function () {
                 }
             }
         }
-        this.fireStrChanged(oldValue, value);
+        this.fireStrChanged(loc, oldValue);
     };
+    Object.defineProperty(LocalizableString.prototype, "curLocale", {
+        get: function () {
+            return !!this.locale ? this.locale : this.defaultLoc;
+        },
+        enumerable: false,
+        configurable: true
+    });
     LocalizableString.prototype.canRemoveLocValue = function (loc, val) {
         if (_settings__WEBPACK_IMPORTED_MODULE_2__["settings"].storeDuplicatedTranslations)
             return false;
@@ -20084,9 +20109,12 @@ var LocalizableString = /** @class */ (function () {
             return val == this.getLocaleText(this.defaultLoc);
         }
     };
-    LocalizableString.prototype.fireStrChanged = function (oldValue, value) {
+    LocalizableString.prototype.fireStrChanged = function (loc, oldValue) {
         this.strChanged();
-        if (!!this.onStrChanged && oldValue !== value) {
+        if (!this.onStrChanged)
+            return;
+        var value = this.pureText;
+        if (loc !== this.curLocale || oldValue !== value) {
             this.onStrChanged(oldValue, value);
         }
     };
@@ -21871,12 +21899,12 @@ var germanSurveyStrings = {
     confirmRemoveFile: "Sind Sie sicher, dass Sie diese Datei löschen möchten: {0}?",
     confirmRemoveAllFiles: "Sind Sie sicher, dass Sie alle Dateien löschen möchten?",
     questionTitlePatternText: "Fragentitel",
-    modalCancelButtonText: "Stornieren",
+    modalCancelButtonText: "Abbrechen",
     modalApplyButtonText: "Anwenden",
     filterStringPlaceholder: "Tippe um zu suchen...",
-    // emptyMessage: "No data to display",
+    emptyMessage: "Es gibt noch keine Daten.",
     noEntriesText: "Es gibt noch keine Einträge.\nKlicken Sie auf die Schaltfläche unten, um einen neuen Eintrag hinzuzufügen.",
-    // more: "More"
+    more: "Mehr"
 };
 survey_core__WEBPACK_IMPORTED_MODULE_0__["surveyLocalization"].locales["de"] = germanSurveyStrings;
 survey_core__WEBPACK_IMPORTED_MODULE_0__["surveyLocalization"].localeNames["de"] = "deutsch";
@@ -26356,7 +26384,7 @@ var PageModel = /** @class */ (function (_super) {
         /**
          * A caption displayed on a navigation button in the TOC or progress bar. Applies when [`showTOC`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#showTOC) is `true` or when [`showProgressBar`](https://surveyjs.io/form-library/documentation/surveymodel#showProgressBar) is `true` and [`progressBarType`](https://surveyjs.io/form-library/documentation/surveymodel#progressBarType) is `"buttons"`.
          *
-         * If this property is undefined, the navigation buttons display page [titles](https://surveyjs.io/form-library/documentation/api-reference/page-model#title) or [names](https://surveyjs.io/form-library/documentation/pagemodel#name).
+         * If navigation titles are unspecified, the navigation buttons display page [titles](https://surveyjs.io/form-library/documentation/api-reference/page-model#title) or [names](https://surveyjs.io/form-library/documentation/pagemodel#name).
          */
         get: function () {
             return this.getLocalizableStringText("navigationTitle");
@@ -30150,6 +30178,11 @@ var PopupDropdownViewModel = /** @class */ (function (_super) {
             var visualViewport = window.visualViewport;
             document.documentElement.style.setProperty("--sv-popup-overlay-height", visualViewport.height * visualViewport.scale + "px");
         };
+        _this.resizeWindowCallback = function () {
+            if (!_this.isOverlay) {
+                _this.updatePosition(true, false);
+            }
+        };
         _this.clientY = 0;
         _this.isTablet = false;
         _this.touchStartEventCallback = function (event) {
@@ -30260,6 +30293,7 @@ var PopupDropdownViewModel = /** @class */ (function (_super) {
             this.updatePosition(true, false);
         }
         this.switchFocus();
+        window.addEventListener("resize", this.resizeWindowCallback);
         if (this.shouldCreateResizeCallback) {
             window.visualViewport.addEventListener("resize", this.resizeEventCallback);
             if (this.container) {
@@ -30295,6 +30329,7 @@ var PopupDropdownViewModel = /** @class */ (function (_super) {
     };
     PopupDropdownViewModel.prototype.updateOnHiding = function () {
         _super.prototype.updateOnHiding.call(this);
+        window.removeEventListener("resize", this.resizeWindowCallback);
         if (this.shouldCreateResizeCallback) {
             window.visualViewport.removeEventListener("resize", this.resizeEventCallback);
             if (this.container) {
@@ -31357,6 +31392,7 @@ var Question = /** @class */ (function (_super) {
     Question.prototype.isReadOnlyRenderDiv = function () {
         return this.isReadOnly && _settings__WEBPACK_IMPORTED_MODULE_8__["settings"].readOnlyCommentRenderMode === "div";
     };
+    Question.prototype.setIsMobile = function (val) { };
     Question.prototype.createLocTitleProperty = function () {
         var _this = this;
         var locTitleValue = _super.prototype.createLocTitleProperty.call(this);
@@ -33561,7 +33597,7 @@ var Question = /** @class */ (function (_super) {
      *
      * Call this method after you assign new question values in code to ensure that they are acceptable.
      *
-     * > This method does not remove values that do not pass validation. Call the `validate()` method to validate newly assigned values.
+     * > This method does not remove values that fail validation. Call the `validate()` method to validate newly assigned values.
      *
      * @see validate
      */
@@ -33725,7 +33761,9 @@ var Question = /** @class */ (function (_super) {
     };
     Question.questionCounter = 100;
     __decorate([
-        Object(_jsonobject__WEBPACK_IMPORTED_MODULE_1__["property"])({ defaultValue: false })
+        Object(_jsonobject__WEBPACK_IMPORTED_MODULE_1__["property"])({ defaultValue: false, onSet: function (val, target) {
+                target.setIsMobile(val);
+            } })
     ], Question.prototype, "isMobile", void 0);
     __decorate([
         Object(_jsonobject__WEBPACK_IMPORTED_MODULE_1__["property"])({ localizable: true })
@@ -37762,9 +37800,6 @@ var QuestionCustomModelBase = /** @class */ (function (_super) {
     QuestionCustomModelBase.prototype.getSurveyData = function () {
         return this;
     };
-    // getSurvey(): ISurvey {
-    //   return this.survey;
-    // }
     QuestionCustomModelBase.prototype.getTextProcessor = function () {
         return this.textProcessor;
     };
@@ -37898,6 +37933,12 @@ var QuestionCustomModel = /** @class */ (function (_super) {
             return;
         _super.prototype.setValue.call(this, name, newValue, locNotification, allowNotifyValueChanged);
     };
+    QuestionCustomModel.prototype.onSetData = function () {
+        _super.prototype.onSetData.call(this);
+        if (!!this.survey && !this.isEmpty()) {
+            this.setValue(this.name, this.value, false, this.allowNotifyValueChanged);
+        }
+    };
     QuestionCustomModel.prototype.hasErrors = function (fireCallback, rec) {
         if (fireCallback === void 0) { fireCallback = true; }
         if (rec === void 0) { rec = null; }
@@ -38565,7 +38606,7 @@ var QuestionDropdownModel = /** @class */ (function (_super) {
     };
     Object.defineProperty(QuestionDropdownModel.prototype, "selectedItemLocText", {
         get: function () {
-            var item = this.selectedItem;
+            var item = this.suggestedItem || this.selectedItem;
             return item === null || item === void 0 ? void 0 : item.locText;
         },
         enumerable: false,
@@ -38692,6 +38733,9 @@ var QuestionDropdownModel = /** @class */ (function (_super) {
     __decorate([
         Object(_jsonobject__WEBPACK_IMPORTED_MODULE_0__["property"])({ defaultValue: 25 })
     ], QuestionDropdownModel.prototype, "choicesLazyLoadPageSize", void 0);
+    __decorate([
+        Object(_jsonobject__WEBPACK_IMPORTED_MODULE_0__["property"])()
+    ], QuestionDropdownModel.prototype, "suggestedItem", void 0);
     return QuestionDropdownModel;
 }(_question_baseselect__WEBPACK_IMPORTED_MODULE_2__["QuestionSelectBase"]));
 
@@ -42190,7 +42234,7 @@ var MatrixDropdownTotalCell = /** @class */ (function (_super) {
         if (!!this.column.totalExpression)
             return this.column.totalExpression;
         if (this.column.totalType == "none")
-            return "";
+            return "''";
         var funName = this.column.totalType + "InArray";
         if (!_functionsfactory__WEBPACK_IMPORTED_MODULE_8__["FunctionFactory"].Instance.hasFunction(funName))
             return "";
@@ -44216,12 +44260,17 @@ var QuestionMatrixDropdownModelBase = /** @class */ (function (_super) {
         configurable: true
     });
     QuestionMatrixDropdownModelBase.prototype.onRowChanging = function (row, columnName, rowValue) {
-        if (!this.survey)
+        if (!this.survey && !this.cellValueChangingCallback)
             return !!rowValue ? rowValue[columnName] : null;
         var options = this.getOnCellValueChangedOptions(row, columnName, rowValue);
         var oldRowValue = this.getRowValueCore(row, this.createNewValue(), true);
         options.oldValue = !!oldRowValue ? oldRowValue[columnName] : null;
-        this.survey.matrixCellValueChanging(this, options);
+        if (!!this.cellValueChangingCallback) {
+            options.value = this.cellValueChangingCallback(row, columnName, options.value, options.oldValue);
+        }
+        if (!!this.survey) {
+            this.survey.matrixCellValueChanging(this, options);
+        }
         return options.value;
     };
     QuestionMatrixDropdownModelBase.prototype.onRowChanged = function (row, columnName, newRowValue, isDeletingValue) {
@@ -48935,6 +48984,13 @@ var QuestionPanelDynamicModel = /** @class */ (function (_super) {
             _super.prototype.setValueCore.call(this, newValue);
         }
     };
+    QuestionPanelDynamicModel.prototype.setIsMobile = function (val) {
+        (this.panels || []).forEach(function (panel) { return panel.elements.forEach(function (element) {
+            if (element instanceof _question__WEBPACK_IMPORTED_MODULE_3__["Question"]) {
+                element.isMobile = val;
+            }
+        }); });
+    };
     Object.defineProperty(QuestionPanelDynamicModel.prototype, "panelCount", {
         /**
          * The number of panels in Dynamic Panel.
@@ -51107,8 +51163,13 @@ var RenderedRatingItem = /** @class */ (function (_super) {
         var _this = _super.call(this) || this;
         _this.itemValue = itemValue;
         _this.locString = locString;
+        _this.locText.onStringChanged.add(_this.onStringChangedCallback.bind(_this));
+        _this.onStringChangedCallback();
         return _this;
     }
+    RenderedRatingItem.prototype.onStringChangedCallback = function () {
+        this.text = this.itemValue.text;
+    };
     Object.defineProperty(RenderedRatingItem.prototype, "value", {
         get: function () {
             return this.itemValue.getPropertyValue("value");
@@ -51123,16 +51184,12 @@ var RenderedRatingItem = /** @class */ (function (_super) {
         enumerable: false,
         configurable: true
     });
-    Object.defineProperty(RenderedRatingItem.prototype, "text", {
-        get: function () {
-            return this.itemValue.text;
-        },
-        enumerable: false,
-        configurable: true
-    });
     __decorate([
         Object(_jsonobject__WEBPACK_IMPORTED_MODULE_2__["property"])({ defaultValue: "" })
     ], RenderedRatingItem.prototype, "highlight", void 0);
+    __decorate([
+        Object(_jsonobject__WEBPACK_IMPORTED_MODULE_2__["property"])({ defaultValue: "" })
+    ], RenderedRatingItem.prototype, "text", void 0);
     return RenderedRatingItem;
 }(_base__WEBPACK_IMPORTED_MODULE_7__["Base"]));
 
@@ -51145,21 +51202,78 @@ var QuestionRatingModel = /** @class */ (function (_super) {
     __extends(QuestionRatingModel, _super);
     function QuestionRatingModel(name) {
         var _this = _super.call(this, name) || this;
+        _this._syncPropertiesChanging = false;
         _this.createItemValues("rateValues");
         _this.createRenderedRateItems();
         _this.createLocalizableString("ratingOptionsCaption", _this, false, true);
-        _this.registerFunctionOnPropertiesValueChanged(["rateValues", "rateMin", "rateMax",
+        _this.registerFunctionOnPropertiesValueChanged(["rateValues", "rateMin", "rateMax", "rateType",
             "minRateDescription", "maxRateDescription", "rateStep", "displayRateDescriptionsAsExtremeItems"], function () { return _this.createRenderedRateItems(); });
         _this.createLocalizableString("minRateDescription", _this, true);
         _this.createLocalizableString("maxRateDescription", _this, true);
+        _this.initPropertyDependencies();
         return _this;
     }
+    QuestionRatingModel.prototype.startLoadingFromJson = function (jsonObj) {
+        _super.prototype.startLoadingFromJson.call(this, jsonObj);
+        this.jsonObj = jsonObj;
+    };
     QuestionRatingModel.prototype.endLoadingFromJson = function () {
         _super.prototype.endLoadingFromJson.call(this);
         this.hasMinRateDescription = !!this.minRateDescription;
         this.hasMaxRateDescription = !!this.maxRateDescription;
+        if (this.jsonObj.rateMin !== undefined && this.jsonObj.rateCount !== undefined && this.jsonObj.rateMax === undefined) {
+            this.updateRateMax();
+        }
+        if (this.jsonObj.rateMax !== undefined && this.jsonObj.rateCount !== undefined && this.jsonObj.rateMin === undefined) {
+            this.updateRateMin();
+        }
+        this.updateRateCount();
         this.createRenderedRateItems();
     };
+    QuestionRatingModel.prototype.registerSychProperties = function (names, func) {
+        var _this = this;
+        this.registerFunctionOnPropertiesValueChanged(names, function () {
+            if (!_this._syncPropertiesChanging) {
+                _this._syncPropertiesChanging = true;
+                func();
+                _this._syncPropertiesChanging = false;
+            }
+        });
+    };
+    QuestionRatingModel.prototype.updateRateMax = function () {
+        this.rateMax = this.rateMin + this.rateStep * (this.rateCount - 1);
+    };
+    QuestionRatingModel.prototype.updateRateMin = function () {
+        this.rateMin = this.rateMax - this.rateStep * (this.rateCount - 1);
+    };
+    QuestionRatingModel.prototype.updateRateCount = function () {
+        if (this.rateValues.length) {
+            this.rateCount = this.rateValues.length;
+        }
+        else {
+            this.rateCount = Math.trunc((this.rateMax - this.rateMin) / (this.rateStep || 1)) + 1;
+        }
+    };
+    QuestionRatingModel.prototype.initPropertyDependencies = function () {
+        var _this = this;
+        this.registerSychProperties(["rateCount"], function () {
+            if (_this.rateValues.length == 0) {
+                _this.rateMax = _this.rateMin + _this.rateStep * (_this.rateCount - 1);
+            }
+            else {
+                if (_this.rateCount < _this.rateValues.length) {
+                    _this.rateValues.splice(_this.rateCount, _this.rateValues.length - _this.rateCount);
+                }
+                else {
+                    for (var i = _this.rateValues.length; i < _this.rateCount; i++)
+                        _this.rateValues.push(new _itemvalue__WEBPACK_IMPORTED_MODULE_0__["ItemValue"](undefined));
+                }
+            }
+        });
+        this.registerSychProperties(["rateMin", "rateMax", "rateStep", "rateValues"], function () {
+            _this.updateRateCount();
+        });
+    };
     Object.defineProperty(QuestionRatingModel.prototype, "rateValues", {
         /**
          * A list of rate values.
@@ -51180,10 +51294,7 @@ var QuestionRatingModel = /** @class */ (function (_super) {
          *
          * If you need to specify only the `value` property, you can set the `rateValues` property to an array of numbers, for example, `[ 3, 6, 10 ]`. These values are both saved in survey results and used as display text.
          *
-         * If you do not specify the `rateValues` property, rate values are generated automatically based upon the `rateMin`, `rateMax`, and `rateStep` property values.
-         * @see rateMin
-         * @see rateMax
-         * @see rateStep
+         * If you do not specify the `rateValues` property, rate values are generated automatically based upon the [`rateMin`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMin), [`rateMax`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMax), [`rateStep`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateStep), and [`rateCount`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateCount) property values.
          */
         get: function () {
             return this.getPropertyValue("rateValues");
@@ -51197,12 +51308,12 @@ var QuestionRatingModel = /** @class */ (function (_super) {
     });
     Object.defineProperty(QuestionRatingModel.prototype, "rateMin", {
         /**
-         * Specifies the first rate value in the generated sequence of rate values. Applies if the `rateValues` array is empty.
+         * Specifies the first rate value in the generated sequence of rate values. Applies if the [`rateValues`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateValues) array is empty.
          *
          * Default value: 1
-         * @see rateValues
          * @see rateMax
          * @see rateStep
+         * @see rateCount
          */
         get: function () {
             return this.getPropertyValue("rateMin");
@@ -51215,12 +51326,12 @@ var QuestionRatingModel = /** @class */ (function (_super) {
     });
     Object.defineProperty(QuestionRatingModel.prototype, "rateMax", {
         /**
-         * Specifies the last rate value in the generated sequence of rate values. Applies if the `rateValues` array is empty.
+         * Specifies the last rate value in the generated sequence of rate values. Applies if the [`rateValues`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateValues) array is empty.
          *
          * Default value: 5
-         * @see rateValues
          * @see rateMin
          * @see rateStep
+         * @see rateCount
          */
         get: function () {
             return this.getPropertyValue("rateMax");
@@ -51233,12 +51344,12 @@ var QuestionRatingModel = /** @class */ (function (_super) {
     });
     Object.defineProperty(QuestionRatingModel.prototype, "rateStep", {
         /**
-         * Specifies a step with which to generate rate values. Applies if the `rateValues` array is empty.
+         * Specifies a step with which to generate rate values. Applies if the [`rateValues`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateValues) array is empty.
          *
          * Default value: 1
-         * @see rateValues
          * @see rateMin
          * @see rateMax
+         * @see rateCount
          */
         get: function () {
             return this.getPropertyValue("rateStep");
@@ -51285,6 +51396,8 @@ var QuestionRatingModel = /** @class */ (function (_super) {
             }
             rateValues = res;
         }
+        if (this.rateType == "smileys" && rateValues.length > 10)
+            rateValues = rateValues.slice(0, 10);
         this.renderedRateItems = rateValues.map(function (v, i) {
             if (_this.displayRateDescriptionsAsExtremeItems) {
                 if (i == 0)
@@ -51504,6 +51617,13 @@ var QuestionRatingModel = /** @class */ (function (_super) {
             itemHoverClass = this.cssClasses.itemSmileyHover;
             itemitemOnErrorClass = this.cssClasses.itemSmileyOnError;
         }
+        var hasFixedSize = !this.isStar &&
+            !this.isSmiley &&
+            (!this.displayRateDescriptionsAsExtremeItems ||
+                this.rateValues.length > 0 && item != this.rateValues[0] && item != this.rateValues[this.rateValues.length - 1] ||
+                this.rateValues.length == 0 && item.value != this.rateMin && item.value != this.rateMax) &&
+            item.locText.calculatedText.length <= 2 &&
+            Number.isInteger(Number(item.locText.calculatedText));
         return new _utils_cssClassBuilder__WEBPACK_IMPORTED_MODULE_6__["CssClassBuilder"]()
             .append(itemClass)
             .append(itemSelectedClass, isSelected)
@@ -51512,6 +51632,7 @@ var QuestionRatingModel = /** @class */ (function (_super) {
             .append(itemHighlightedClass, isHighlighted)
             .append(itemUnhighlightedClass, isUnhighlighted)
             .append(itemitemOnErrorClass, this.errors.length > 0)
+            .append(this.cssClasses.itemFixedSize, hasFixedSize)
             .toString();
     };
     //methods for mobile view
@@ -51628,6 +51749,9 @@ var QuestionRatingModel = /** @class */ (function (_super) {
         }
         return classes;
     };
+    __decorate([
+        Object(_jsonobject__WEBPACK_IMPORTED_MODULE_2__["property"])({ defaultValue: 5 })
+    ], QuestionRatingModel.prototype, "rateCount", void 0);
     __decorate([
         Object(_jsonobject__WEBPACK_IMPORTED_MODULE_2__["propertyArray"])()
     ], QuestionRatingModel.prototype, "renderedRateItems", void 0);
@@ -51666,6 +51790,10 @@ var QuestionRatingModel = /** @class */ (function (_super) {
 
 _jsonobject__WEBPACK_IMPORTED_MODULE_2__["Serializer"].addClass("rating", [
     { name: "showCommentArea:switch", layout: "row", visible: true, category: "general" },
+    {
+        name: "rateCount:number",
+        default: 5
+    },
     {
         name: "rateValues:itemvalue[]",
         baseValue: function () {
@@ -56202,7 +56330,7 @@ var TitleElement = /** @class */ (function (_super) {
             };
         }
         var CustomTag = element.titleTagName;
-        return (react__WEBPACK_IMPORTED_MODULE_0___default.a.createElement(CustomTag, { className: element.cssTitle, id: element.ariaTitleId, "aria-label": ariaLabel, tabIndex: element.titleTabIndex, "aria-expanded": element.titleAriaExpanded, role: "button", onClick: onClick, onKeyUp: onKeyUp }, titleContent));
+        return (react__WEBPACK_IMPORTED_MODULE_0___default.a.createElement(CustomTag, { className: element.cssTitle, id: element.ariaTitleId, "aria-label": ariaLabel, tabIndex: element.titleTabIndex, "aria-expanded": element.titleAriaExpanded, role: element.titleAriaRole, onClick: onClick, onKeyUp: onKeyUp }, titleContent));
     };
     return TitleElement;
 }(react__WEBPACK_IMPORTED_MODULE_0___default.a.Component));
@@ -57850,8 +57978,14 @@ var Survey = /** @class */ (function (_super) {
         }
         var rootCss = this.survey.getRootCss();
         var cssClasses = this.rootNodeClassName ? this.rootNodeClassName + " " + rootCss : rootCss;
-        return (react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("div", { id: this.rootNodeId, ref: this.rootRef, className: cssClasses },
-            react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("form", { onSubmit: onSubmit },
+        var rootStyle = {
+            backgroundImage: this.survey.renderBackgroundImage
+        };
+        var formStyle = {
+            backgroundColor: this.survey.renderBackgroundOpacity
+        };
+        return (react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("div", { id: this.rootNodeId, ref: this.rootRef, className: cssClasses, style: rootStyle },
+            react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("form", { onSubmit: onSubmit, style: formStyle },
                 customHeader,
                 react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("div", { className: this.css.container },
                     header,
@@ -57991,9 +58125,7 @@ var Survey = /** @class */ (function (_super) {
     };
     //ISurveyCreator
     Survey.prototype.createQuestionElement = function (question) {
-        return _reactquestion_factory__WEBPACK_IMPORTED_MODULE_6__["ReactQuestionFactory"].Instance.createQuestion(!question.isDefaultRendering || question.isDefaultRendering()
-            ? question.getTemplate()
-            : question.getComponentName(), {
+        return _reactquestion_factory__WEBPACK_IMPORTED_MODULE_6__["ReactQuestionFactory"].Instance.createQuestion(question.isDefaultRendering() ? question.getTemplate() : question.getComponentName(), {
             question: question,
             isDisplayMode: question.isInputReadOnly,
             creator: this,
@@ -63791,6 +63923,11 @@ var SurveyElementCore = /** @class */ (function (_super) {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(SurveyElementCore.prototype, "titleAriaRole", {
+        get: function () { return undefined; },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(SurveyElementCore.prototype, "ariaLabel", {
         get: function () {
             return this.locTitle.renderedHtml;
@@ -64149,6 +64286,15 @@ var SurveyElement = /** @class */ (function (_super) {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(SurveyElement.prototype, "titleAriaRole", {
+        get: function () {
+            if (this.isPage || this.state === "default")
+                return undefined;
+            return "button";
+        },
+        enumerable: false,
+        configurable: true
+    });
     SurveyElement.prototype.setSurveyImpl = function (value, isLight) {
         this.surveyImplValue = value;
         if (!this.surveyImplValue) {
@@ -65337,7 +65483,6 @@ var SurveyModel = /** @class */ (function (_super) {
          * For information on event handler parameters, refer to descriptions within the interface.
          *
          * [View Demo](https://surveyjs.io/form-library/examples/file-delayed-upload/ (linkStyle))
-         * @see clearFiles
          * @see onDownloadFile
          * @see onUploadFiles
          */
@@ -65676,6 +65821,7 @@ var SurveyModel = /** @class */ (function (_super) {
         _this.createHtmlLocString("completedBeforeHtml", "completingSurveyBefore", htmlCallBack);
         _this.createHtmlLocString("loadingHtml", "loadingSurvey", htmlCallBack);
         _this.createLocalizableString("logo", _this, false);
+        _this.createLocalizableString("backgroundImage", _this, false);
         _this.createLocalizableString("startSurveyText", _this, false, true);
         _this.createLocalizableString("pagePrevText", _this, false, true);
         _this.createLocalizableString("pageNextText", _this, false, true);
@@ -65726,6 +65872,7 @@ var SurveyModel = /** @class */ (function (_super) {
         _this.registerPropertyChangedHandlers(["isLoading", "isCompleted", "isCompletedBefore", "mode", "isStartedState", "currentPage"], function () { _this.updateState(); });
         _this.registerPropertyChangedHandlers(["state", "currentPage", "showPreviewBeforeComplete"], function () { _this.onStateAndCurrentPageChanged(); });
         _this.registerPropertyChangedHandlers(["logo", "logoPosition"], function () { _this.updateHasLogo(); });
+        _this.registerPropertyChangedHandlers(["backgroundImage"], function () { _this.updateRenderBackgroundImage(); });
         _this.onGetQuestionNo.onCallbacksChanged = function () {
             _this.resetVisibleIndexes();
         };
@@ -66117,7 +66264,9 @@ var SurveyModel = /** @class */ (function (_super) {
     });
     Object.defineProperty(SurveyModel.prototype, "surveyId", {
         /**
-         * Gets or sets an identifier of a survey model loaded from the [api.surveyjs.io](https://api.surveyjs.io) service. When specified, the survey JSON is automatically loaded from [api.surveyjs.io](https://api.surveyjs.io) service.
+         * The identifier of a survey JSON schema to load from the [SurveyJS Service](https://api.surveyjs.io).
+         *
+         * Refer to the following help topic for more information: [Store Survey Results in the SurveyJS Service](https://surveyjs.io/form-library/documentation/handle-survey-results-store#store-survey-results-in-the-surveyjs-service).
          * @see loadSurveyFromService
          * @see onLoadedSurveyFromService
          */
@@ -66132,7 +66281,9 @@ var SurveyModel = /** @class */ (function (_super) {
     });
     Object.defineProperty(SurveyModel.prototype, "surveyPostId", {
         /**
-         * Gets or sets an identifier of a survey model saved to the [api.surveyjs.io](https://api.surveyjs.io) service. When specified, the survey data is automatically saved to the [api.surveyjs.io](https://api.surveyjs.io) service.
+         * An identifier used to save survey results to the [SurveyJS Service](https://api.surveyjs.io).
+         *
+         * Refer to the following help topic for more information: [Store Survey Results in the SurveyJS Service](https://surveyjs.io/form-library/documentation/handle-survey-results-store#store-survey-results-in-the-surveyjs-service).
          * @see onComplete
          * @see surveyShowDataSaving
          */
@@ -66147,9 +66298,10 @@ var SurveyModel = /** @class */ (function (_super) {
     });
     Object.defineProperty(SurveyModel.prototype, "clientId", {
         /**
-         * Gets or sets user's identifier (e.g., e-mail or unique customer id) in your web application.
-         * If you load survey or post survey results from/to [api.surveyjs.io](https://api.surveyjs.io) service, then the library do not allow users to run the same survey the second time.
-         * On the second run, the user will see the survey complete page.
+         * A user identifier (e-mail or other unique ID).
+         *
+         * If your application works with the [SurveyJS Service](https://api.surveyjs.io), the ID ensures that users do not pass the same survey twice. On the second run, they will see the [Completed Before page](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#completedBeforeHtml).
+         * @see cookieName
          */
         get: function () {
             return this.getPropertyValue("clientId", "");
@@ -66162,9 +66314,10 @@ var SurveyModel = /** @class */ (function (_super) {
     });
     Object.defineProperty(SurveyModel.prototype, "cookieName", {
         /**
-         * Gets or sets a cookie name used to save information about completing the survey.
-         * If the property is not empty, before starting the survey, the Survey library checks if the cookie with this name exists.
-         * If it is `true`, the survey goes to complete mode and a user sees the survey complete page. On completing the survey the cookie with this name is created.
+         * A cookie name used to save information about survey completion.
+         *
+         * When this property has a value, the survey creates a cookie with the specified name on completion. This cookie helps ensure that users do not pass the same survey twice. On the second run, they will see the [Completed Before page](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#completedBeforeHtml).
+         * @see cliendId
          */
         get: function () {
             return this.getPropertyValue("cookieName", "");
@@ -66606,15 +66759,17 @@ var SurveyModel = /** @class */ (function (_super) {
     });
     Object.defineProperty(SurveyModel.prototype, "clearInvisibleValues", {
         /**
-         * Gets or sets a value that specifies how the invisible data is included in survey data.
+         * Specifies when to remove values of invisible questions from [survey results](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#data).
          *
-         * The following options are available:
+         * Possible values:
          *
-         * - `none` - include the invisible values into the survey data.
-         * - `onHidden` - clear the question value when it becomes invisible. If a question has value and it was invisible initially then survey clears the value on completing.
-         * - `onHiddenContainer` - clear the question value when it or its parent (page or panel) becomes invisible. If a question has value and it was invisible initially then survey clears the value on completing.
-         * - `onComplete` (default) - clear invisible question values on survey complete. In this case, the invisible questions will not be stored on the server.
-         * @see Question.visible
+         * - `"onComplete"` (default) - Clears invisible question values when the survey is complete.
+         * - `"onHidden"` - Clears a question value when the question becomes invisible. If the question is invisible initially, its value is removed on survey completion.
+         * - `"onHiddenContainer"` - Clears a question value when the question or its containter (page or panel) becomes invisible. If the question is invisible initially, its value is removed on survey completion.
+         * - `"none"` - Keeps invisible values in survey results.
+         * - `true` - Equivalent to `"onComplete"`.
+         * - `false` - Equivalent to `"none"`.
+         * @see [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#conditional-visibility)
          * @see onComplete
          */
         get: function () {
@@ -66631,21 +66786,19 @@ var SurveyModel = /** @class */ (function (_super) {
         configurable: true
     });
     /**
-     * Call this function to remove all question values from the survey, that end-user will not be able to enter.
-     * For example the value that doesn't exists in a radiogroup/dropdown/checkbox choices or matrix rows/columns.
-     * Please note, this function doesn't clear values for invisible questions or values that doesn't associated with questions.
-     * In fact this function just call clearIncorrectValues function of all questions in the survey
-     * @param removeNonExisingRootKeys - set this parameter to true to remove keys from survey.data that doesn't have corresponded questions and calculated values
-     * @see Question.clearIncorrectValues
-     * @see Page.clearIncorrectValues
-     * @see Panel.clearIncorrectValues
+     * Removes values that cannot be assigned to a question, for example, choices unlisted in the `choices` array.
+     *
+     * Call this method after you assign new question values in code to ensure that they are acceptable.
+     *
+     * > This method does not remove values that fail validation. Call the [`validate()`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#validate) method to validate newly assigned values.
+     * @param removeNonExistingRootKeys Pass `true` to remove values that do not correspond to any question or [calculated value](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#calculated-values).
      */
-    SurveyModel.prototype.clearIncorrectValues = function (removeNonExisingRootKeys) {
-        if (removeNonExisingRootKeys === void 0) { removeNonExisingRootKeys = false; }
+    SurveyModel.prototype.clearIncorrectValues = function (removeNonExistingRootKeys) {
+        if (removeNonExistingRootKeys === void 0) { removeNonExistingRootKeys = false; }
         for (var i = 0; i < this.pages.length; i++) {
             this.pages[i].clearIncorrectValues();
         }
-        if (!removeNonExisingRootKeys)
+        if (!removeNonExistingRootKeys)
             return;
         var data = this.data;
         var hasChanges = false;
@@ -66672,7 +66825,7 @@ var SurveyModel = /** @class */ (function (_super) {
     };
     Object.defineProperty(SurveyModel.prototype, "keepIncorrectValues", {
         /**
-         * Specifies whether to keep values that cannot be assigned to questions, for example, choices unlisted in the choices array.
+         * Specifies whether to keep values that cannot be assigned to questions, for example, choices unlisted in the `choices` array.
          *
          * > This property cannot be specified in the survey JSON schema. Use dot notation to specify it.
          * @see clearIncorrectValues
@@ -67019,14 +67172,58 @@ var SurveyModel = /** @class */ (function (_super) {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(SurveyModel.prototype, "backgroundImage", {
+        /**
+         * Gets or sets a survey backgroundImage.
+         */
+        get: function () {
+            return this.getLocalizableStringText("backgroundImage");
+        },
+        set: function (value) {
+            this.setLocalizableStringText("backgroundImage", value);
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(SurveyModel.prototype, "locBackgroundImage", {
+        get: function () {
+            return this.getLocalizableString("backgroundImage");
+        },
+        enumerable: false,
+        configurable: true
+    });
+    SurveyModel.prototype.updateRenderBackgroundImage = function () {
+        this.renderBackgroundImage = ["url(", this.getLocalizableString("backgroundImage").renderedHtml, ")"].join("");
+    };
+    Object.defineProperty(SurveyModel.prototype, "backgroundOpacity", {
+        get: function () {
+            return this.getPropertyValue("backgroundOpacity");
+        },
+        set: function (val) {
+            this.setPropertyValue("backgroundOpacity", val);
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(SurveyModel.prototype, "renderBackgroundOpacity", {
+        get: function () {
+            var backgroundOpacityProperty = this.getPropertyByName("backgroundOpacity");
+            if (backgroundOpacityProperty.isDefaultValue(this.backgroundOpacity)) {
+                return "";
+            }
+            var alpha = 1 - this.backgroundOpacity;
+            return ["rgba(255, 255, 255, ", alpha, ")"].join("");
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(SurveyModel.prototype, "completedHtml", {
         /**
-         * Gets or sets the HTML content displayed on the complete page. Use this property to change the default complete page text.
+         * HTML content displayed on the [complete page](https://surveyjs.io/form-library/documentation/design-survey/create-a-multi-page-survey#complete-page).
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/modify-survey-navigation-settings/ (linkStyle))
          * @see showCompletedPage
          * @see completedHtmlOnCondition
-         * @see locale
-         *
-         * [View Demo](https://surveyjs.io/form-library/examples/survey-options/ (linkStyle))
          */
         get: function () {
             return this.getLocalizableStringText("completedHtml");
@@ -67046,9 +67243,11 @@ var SurveyModel = /** @class */ (function (_super) {
     });
     Object.defineProperty(SurveyModel.prototype, "completedHtmlOnCondition", {
         /**
-         * The list of HTML condition items. If the expression of this item returns `true`, then a survey will use this item HTML instead of `completedHtml`.
-         * @see HtmlConditionItem
-         * @see completeHtml
+         * An array of objects that allows you to specify different HTML content for the [complete page](https://surveyjs.io/form-library/documentation/design-survey/create-a-multi-page-survey#complete-page).
+         *
+         * Each object should include the [`expression`](https://surveyjs.io/form-library/documentation/api-reference/htmlconditionitem#expression) and [`html`](https://surveyjs.io/form-library/documentation/api-reference/htmlconditionitem#html) properties. When `expression` evaluates to `true`, the survey uses the corresponding HTML markup instead of [`completedHtml`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#completedHtml). Refer to the following help topic for more information about expressions: [Expressions](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions).
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/nps-question/ (linkStyle))
          */
         get: function () {
             return this.getPropertyValue("completedHtmlOnCondition");
@@ -67109,9 +67308,10 @@ var SurveyModel = /** @class */ (function (_super) {
     };
     Object.defineProperty(SurveyModel.prototype, "completedBeforeHtml", {
         /**
-         * The HTML content displayed to an end user that has already completed the survey.
+         * HTML content displayed to a user who has completed the survey before.
          * @see clientId
-         * @see locale
+         * @see cookieName
+         * @see processedCompletedBeforeHtml
          */
         get: function () {
             return this.getLocalizableStringText("completedBeforeHtml");
@@ -67131,9 +67331,9 @@ var SurveyModel = /** @class */ (function (_super) {
     });
     Object.defineProperty(SurveyModel.prototype, "loadingHtml", {
         /**
-         * The HTML that shows on loading survey Json from the [api.surveyjs.io](https://api.surveyjs.io) service.
+         * HTML content displayed while a survey JSON schema is being loaded from the [SurveyJS Service](https://api.surveyjs.io).
          * @see surveyId
-         * @see locale
+         * @see processedLoadingHtml
          */
         get: function () {
             return this.getLocalizableStringText("loadingHtml");
@@ -67152,10 +67352,6 @@ var SurveyModel = /** @class */ (function (_super) {
         configurable: true
     });
     Object.defineProperty(SurveyModel.prototype, "defaultLoadingHtml", {
-        /**
-         * Default value for loadingHtml property
-         * @see loadingHtml
-         */
         get: function () {
             return "<h3>" + this.getLocalizationString("loadingSurvey") + "</h3>";
         },
@@ -67992,8 +68188,9 @@ var SurveyModel = /** @class */ (function (_super) {
     };
     Object.defineProperty(SurveyModel.prototype, "comments", {
         /**
-         * Returns all comments from the data.
-         * @see data
+         * An object with all comment values.
+         * @see Question.showCommentArea
+         * @see storeOthersAsComment
          */
         get: function () {
             var result = {};
@@ -68454,14 +68651,9 @@ var SurveyModel = /** @class */ (function (_super) {
         page.updateCustomWidgets();
     };
     SurveyModel.prototype.currentPageChanging = function (newValue, oldValue) {
-        var options = {
-            oldCurrentPage: oldValue,
-            newCurrentPage: newValue,
-            allowChanging: true,
-            allow: true,
-            isNextPage: this.isNextPage(newValue, oldValue),
-            isPrevPage: this.isPrevPage(newValue, oldValue),
-        };
+        var options = this.createPageChangeEventOptions(newValue, oldValue);
+        options.allow = true;
+        options.allowChanging = true;
         this.onCurrentPageChanging.fire(this, options);
         var allow = options.allowChanging && options.allow;
         if (allow) {
@@ -68470,26 +68662,22 @@ var SurveyModel = /** @class */ (function (_super) {
         return allow;
     };
     SurveyModel.prototype.currentPageChanged = function (newValue, oldValue) {
-        var isNextPage = this.isNextPage(newValue, oldValue);
-        if (isNextPage) {
+        var options = this.createPageChangeEventOptions(newValue, oldValue);
+        if (options.isNextPage) {
             oldValue.passed = true;
         }
-        this.onCurrentPageChanged.fire(this, {
+        this.onCurrentPageChanged.fire(this, options);
+    };
+    SurveyModel.prototype.createPageChangeEventOptions = function (newValue, oldValue) {
+        var diff = !!newValue && !!oldValue ? newValue.visibleIndex - oldValue.visibleIndex : 0;
+        return {
             oldCurrentPage: oldValue,
             newCurrentPage: newValue,
-            isNextPage: isNextPage,
-            isPrevPage: this.isPrevPage(newValue, oldValue),
-        });
-    };
-    SurveyModel.prototype.isNextPage = function (newValue, oldValue) {
-        if (!newValue || !oldValue)
-            return false;
-        return newValue.visibleIndex == oldValue.visibleIndex + 1;
-    };
-    SurveyModel.prototype.isPrevPage = function (newValue, oldValue) {
-        if (!newValue || !oldValue)
-            return false;
-        return newValue.visibleIndex + 1 == oldValue.visibleIndex;
+            isNextPage: diff === 1,
+            isPrevPage: diff === -1,
+            isGoingForward: diff > 0,
+            isGoingBackward: diff < 0
+        };
     };
     /**
      * Returns the progress that a user made while going through the survey.
@@ -69034,11 +69222,11 @@ var SurveyModel = /** @class */ (function (_super) {
         return true;
     };
     /**
-     * Completes the survey, if the current page is the last one. It returns `false` if the last page has errors.
-     * If the last page has no errors, `completeLastPage` calls `doComplete` and returns `true`.
+     * Completes the survey if it currently displays the last page and the page contains no validation errors. If both these conditions are met, this method returns `true`; otherwise, `false`.
+     *
+     * If you want to complete the survey regardless of the current page and validation errors, use the [`doComplete()`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#completeLastPage) event.
      * @see isCurrentPageValid
      * @see nextPage
-     * @see doComplete
      */
     SurveyModel.prototype.completeLastPage = function () {
         var res = this.doCurrentPageComplete(true);
@@ -69444,26 +69632,19 @@ var SurveyModel = /** @class */ (function (_super) {
     /**
      * Completes the survey.
      *
-     * Calling this function performs the following tasks:
+     * When you call this method, Form Library performs the following actions:
      *
-     * - writes cookie if the `cookieName` property is not empty
-     * - sets the survey into `completed` state
-     * - fires the `onComplete` event
-     * - calls `sendResult` function.
+     * 1. Saves a cookie if the [`cookieName`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#cookieName) property is set.
+     * 1. Switches the survey [`state`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#state) to `"completed"`.
+     * 1. Raises the [`onComplete`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onComplete) event.
+     * 1. Navigates the user to a URL specified by the [`navigateToUrl`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#navigateToUrl) or [`navigateToUrlOnCondition`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#navigateToUrlOnCondition) property.
+     * 1. Calls the [`sendResult()`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#sendResult) method if Form Library works with the [SurveyJS Service](https://api.surveyjs.io/).
      *
-     * Calling the `doComplete` function does not perform any validation, unlike the `completeLastPage` function.
-     * The function can return false, if you set options.allowComplete to false in onCompleting event. Otherwise it returns true.
-     * It calls `navigateToUrl` after calling `onComplete` event.
-     * In case calling `options.showSaveInProgress` callback in the `onComplete` event, `navigateToUrl` is used on calling `options.showSaveSuccess` callback.
-     * @see completeLastPage
-     * @see onCompleting
-     * @see cookieName
-     * @see state
-     * @see onComplete
+     * The `doComplete()` method completes the survey regardless of validation errors and the current page. If you need to ensure that survey results are valid and full, call the [`completeLastPage()`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#completeLastPage) method instead.
+     *
+     * @param isCompleteOnTrigger For internal use.
+     * @returns `false` if survey completion is cancelled within the [`onCompleting`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onCompleting) event handler; otherwise, `true`.
      * @see surveyPostId
-     * @see completeLastPage
-     * @see navigateToUrl
-     * @see navigateToUrlOnCondition
      */
     SurveyModel.prototype.doComplete = function (isCompleteOnTrigger) {
         if (isCompleteOnTrigger === void 0) { isCompleteOnTrigger = false; }
@@ -70181,13 +70362,6 @@ var SurveyModel = /** @class */ (function (_super) {
             callback: callback,
         });
     };
-    /**
-     * Clears files from server.
-     * @param question question
-     * @param name question name
-     * @param value file question value
-     * @param callback call back function to get the status of the clearing operation
-     */
     SurveyModel.prototype.clearFiles = function (question, name, value, fileName, callback) {
         if (this.onClearFiles.isEmpty) {
             !!callback && callback("success", value);
@@ -70946,6 +71120,7 @@ var SurveyModel = /** @class */ (function (_super) {
         this.isEndLoadingFromJson = null;
         this.updateVisibleIndexes();
         this.updateHasLogo();
+        this.updateRenderBackgroundImage();
         this.updateCurrentPage();
         this.hasDescription = !!this.description;
         this.setCalculatedWidthModeUpdater();
@@ -71423,8 +71598,11 @@ var SurveyModel = /** @class */ (function (_super) {
     };
     Object.defineProperty(SurveyModel.prototype, "clearValueOnDisableItems", {
         /**
-         * Gets or sets whether to clear value on disable items in checkbox, dropdown and radiogroup questions.
-         * By default, values are not cleared on disabled the corresponded items. This property is not persisted in survey JSON and you have to set it in code.
+         * Specifies whether to remove disabled choices from the value in [Dropdown](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model), [Checkboxes](https://surveyjs.io/form-library/documentation/api-reference/checkbox-question-model), and [Radio Button Group](https://surveyjs.io/form-library/documentation/api-reference/radio-button-question-model) questions.
+         *
+         * Default value: `false`
+         *
+         * > This property cannot be specified in the survey JSON schema. Use dot notation to specify it.
          */
         get: function () {
             return this.getPropertyValue("clearValueOnDisableItems", false);
@@ -72339,6 +72517,9 @@ var SurveyModel = /** @class */ (function (_super) {
     __decorate([
         Object(_jsonobject__WEBPACK_IMPORTED_MODULE_1__["property"])()
     ], SurveyModel.prototype, "_isMobile", void 0);
+    __decorate([
+        Object(_jsonobject__WEBPACK_IMPORTED_MODULE_1__["property"])()
+    ], SurveyModel.prototype, "renderBackgroundImage", void 0);
     __decorate([
         Object(_jsonobject__WEBPACK_IMPORTED_MODULE_1__["property"])()
     ], SurveyModel.prototype, "rootCss", void 0);
@@ -72584,6 +72765,8 @@ _jsonobject__WEBPACK_IMPORTED_MODULE_1__["Serializer"].addClass("survey", [
         choices: ["auto", "static", "responsive"],
     },
     "width",
+    { name: "backgroundImage", serializationProperty: "locBackgroundImage", visible: false },
+    { name: "backgroundOpacity:number", minValue: 0, maxValue: 1, default: 1, visible: false },
     { name: "showBrandInfo:boolean", default: false, visible: false }
 ]);