survey-core 1.12.20 → 1.12.22

package/survey.core.js

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - Survey JavaScript library v1.12.20
+ * surveyjs - Survey JavaScript library v1.12.22
  * Copyright (c) 2015-2025 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */
@@ -8795,6 +8795,8 @@ var base_Base = /** @class */ (function () {
      * @param val A new value for the property.
      */
     Base.prototype.setPropertyValue = function (name, val) {
+        if (this.isDisposedValue)
+            return;
         if (!this.isLoadingFromJson) {
             var prop = this.getPropertyByName(name);
             if (!!prop) {
@@ -8811,9 +8813,11 @@ var base_Base = /** @class */ (function () {
             }
         }
         else {
-            this.setPropertyValueDirectly(name, val);
-            if (!this.isDisposedValue && !this.isTwoValueEquals(oldValue, val)) {
-                this.propertyValueChanged(name, oldValue, val);
+            if (val !== oldValue) {
+                this.setPropertyValueDirectly(name, val);
+                if (!this.isTwoValueEquals(oldValue, val)) {
+                    this.propertyValueChanged(name, oldValue, val);
+                }
             }
         }
     };
@@ -22282,9 +22286,12 @@ var choicesRestful_ChoicesRestful = /** @class */ (function (_super) {
         if (this.processedPath.indexOf(";") > -1) {
             pathes = this.path.split(";");
         }
-        else {
+        else if (this.processedPath.indexOf(",") > -1) {
             pathes = this.processedPath.split(",");
         }
+        else {
+            pathes = this.processedPath.split(".");
+        }
         if (pathes.length == 0)
             pathes.push(this.processedPath);
         return pathes;
@@ -22873,13 +22880,18 @@ var textPreProcessor_TextPreProcessor = /** @class */ (function () {
                     var item = new TextPreProcessorItem();
                     item.start = start;
                     item.end = i;
-                    items.push(item);
+                    if (this.isValidItemName(text.substring(start + 1, i - 1))) {
+                        items.push(item);
+                    }
                 }
                 start = -1;
             }
         }
         return items;
     };
+    TextPreProcessor.prototype.isValidItemName = function (name) {
+        return !!name && name.indexOf(":") < 0;
+    };
     TextPreProcessor.prototype.getName = function (name) {
         if (!name)
             return;
@@ -23009,6 +23021,7 @@ var question_custom_extends = (undefined && undefined.__extends) || (function ()
 
 
 
+
 var question_custom_ComponentQuestionJSON = /** @class */ (function () {
     function ComponentQuestionJSON(name, json) {
         this.name = name;
@@ -24011,6 +24024,36 @@ var question_custom_QuestionCompositeModel = /** @class */ (function (_super) {
         this.settingNewValue = false;
         this.runPanelTriggers(QuestionCompositeModel.ItemVariableName + "." + name, newValue);
     };
+    QuestionCompositeModel.prototype.setComment = function (name, newValue, locNotification) {
+        var val = this.getUnbindValue(this.value);
+        var commentName = this.getCommentName(name);
+        if (!val && !newValue || !!newValue && !!val && val[commentName] === newValue)
+            return;
+        if (!!newValue) {
+            if (!val) {
+                val = {};
+            }
+            val[commentName] = newValue;
+        }
+        else {
+            delete val[commentName];
+        }
+        var q = this.getQuestionByName(name);
+        if (!!q && q.comment !== newValue) {
+            q.comment = newValue;
+        }
+        this.value = val;
+    };
+    QuestionCompositeModel.prototype.getComment = function (name) {
+        var q = this.getQuestionByName(name);
+        if (!!q)
+            return q.comment;
+        var val = this.value;
+        return !!val && val[this.getCommentName(name)] || "";
+    };
+    QuestionCompositeModel.prototype.getCommentName = function (name) {
+        return name + settings.commentSuffix;
+    };
     QuestionCompositeModel.prototype.runPanelTriggers = function (name, value) {
         if (!!this.contentPanel) {
             this.contentPanel.questions.forEach(function (q) {
@@ -24090,19 +24133,24 @@ var question_custom_QuestionCompositeModel = /** @class */ (function (_super) {
         _super.prototype.setQuestionValue.call(this, newValue, updateIsAnswered);
     };
     QuestionCompositeModel.prototype.setValuesIntoQuestions = function (newValue) {
-        if (!this.contentPanel)
+        if (!this.contentPanel || this.settingNewValue)
             return;
         newValue = this.getValueForContentPanel(newValue);
         var oldSettingNewValue = this.settingNewValue;
         this.settingNewValue = true;
         var questions = this.contentPanel.questions;
         for (var i = 0; i < questions.length; i++) {
-            var key = questions[i].getValueName();
-            var val = !!newValue ? newValue[key] : undefined;
             var q = questions[i];
+            var key = q.getValueName();
+            var commentKey = this.getCommentName(key);
+            var val = !!newValue ? newValue[key] : undefined;
+            var commentVal = !!newValue && newValue[commentKey] || "";
             if (!this.isTwoValueEquals(q.value, val) && (val !== undefined || !q.isEmpty())) {
                 q.value = val;
             }
+            if (q.comment !== commentVal) {
+                q.comment = commentVal;
+            }
         }
         this.settingNewValue = oldSettingNewValue;
     };
@@ -35158,7 +35206,7 @@ var panel_PanelModelBase = /** @class */ (function (_super) {
     };
     PanelModelBase.prototype.randomizeElements = function (isRandom) {
         if (!this.canRandomize(isRandom) || this.isRandomizing)
-            return;
+            return false;
         this.isRandomizing = true;
         var oldElements = [];
         var elements = this.elements;
@@ -35170,6 +35218,7 @@ var panel_PanelModelBase = /** @class */ (function (_super) {
         this.updateRows();
         this.updateVisibleIndexes();
         this.isRandomizing = false;
+        return true;
     };
     Object.defineProperty(PanelModelBase.prototype, "areQuestionsRandomized", {
         /**
@@ -35728,6 +35777,14 @@ var panel_PanelModelBase = /** @class */ (function (_super) {
         }
         return null;
     };
+    PanelModelBase.prototype.getFirstVisibleQuestion = function () {
+        var qs = this.questions;
+        for (var i = 0; i < qs.length; i++) {
+            if (qs[i].isVisible)
+                return qs[i];
+        }
+        return null;
+    };
     /**
      * Focuses the first question in this panel/page.
      * @see focusFirstErrorQuestion
@@ -37940,6 +37997,7 @@ var page_PageModel = /** @class */ (function (_super) {
         configurable: true
     });
     PageModel.prototype.setWasShown = function (val) {
+        var _a;
         if (val == this.hasShownValue)
             return;
         this.hasShownValue = val;
@@ -37951,7 +38009,12 @@ var page_PageModel = /** @class */ (function (_super) {
                 els[i].randomizeElements(this.areQuestionsRandomized);
             }
         }
-        this.randomizeElements(this.areQuestionsRandomized);
+        if (this.randomizeElements(this.areQuestionsRandomized)) {
+            var singleQuestion = (_a = this.survey) === null || _a === void 0 ? void 0 : _a.currentSingleQuestion;
+            if ((singleQuestion === null || singleQuestion === void 0 ? void 0 : singleQuestion.page) === this) {
+                this.survey.currentSingleQuestion = this.getFirstVisibleQuestion();
+            }
+        }
     };
     /**
      * Scrolls this page to the top.
@@ -38643,7 +38706,7 @@ var survey_SurveyModel = /** @class */ (function (_super) {
          *
          * For information on event handler parameters, refer to descriptions within the interface.
          *
-         * To handle value changes in matrix cells or panels within a [Dynamic Panel](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model), use the [`onMatrixCellValueChanged`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onMatrixCellValueChanged) or [`onDynamicPanelItemValueChanged`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onDynamicPanelItemValueChanged) event.
+         * To handle value changes in matrix cells or panels within a [Dynamic Panel](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model), use the [`onMatrixCellValueChanged`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onMatrixCellValueChanged) or [`onDynamicPanelValueChanged`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onDynamicPanelValueChanged) event.
          * @see setValue
          */
         _this.onValueChanged = _this.addEvent();
@@ -39171,9 +39234,17 @@ var survey_SurveyModel = /** @class */ (function (_super) {
         _this.onTimer = _this.onTimerTick;
         _this.onTimerPanelInfoText = _this.addEvent();
         /**
-         * An event that is raised after an item value is changed in a panel within a [Dynamic Panel](https://surveyjs.io/form-library/examples/questiontype-paneldynamic/) question.
+         * An event that is raised after a value is changed in a panel within a [Dynamic Panel](https://surveyjs.io/form-library/examples/questiontype-paneldynamic/) question.
          */
-        _this.onDynamicPanelItemValueChanged = _this.addEvent();
+        _this.onDynamicPanelValueChanged = _this.addEvent();
+        /**
+         * @deprecated Use the [`onDynamicPanelValueChanged`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onDynamicPanelValueChanged) event instead.
+         */
+        _this.onDynamicPanelItemValueChanged = _this.onDynamicPanelValueChanged;
+        /**
+         * An event that is raised before a value is changed in a panel within a [Dynamic Panel](https://surveyjs.io/form-library/examples/questiontype-paneldynamic/) question.
+         */
+        _this.onDynamicPanelValueChanging = _this.addEvent();
         /**
          * An event that is raised before a [Dynamic Panel](https://surveyjs.io/form-library/examples/questiontype-paneldynamic/) renders [tab titles](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model#templateTabTitle). Use this event to change individual tab titles.
          *
@@ -41601,6 +41672,10 @@ var survey_SurveyModel = /** @class */ (function (_super) {
             return this.getPropertyValue("showProgressBar");
         },
         set: function (newValue) {
+            if (newValue === true)
+                newValue = "auto";
+            if (newValue === false)
+                newValue = "off";
             this.setPropertyValue("showProgressBar", newValue.toLowerCase());
         },
         enumerable: false,
@@ -42272,7 +42347,7 @@ var survey_SurveyModel = /** @class */ (function (_super) {
             if (newPage == this.currentPage)
                 return;
             var oldValue = this.currentPage;
-            if (!this.isShowingPreview && !this.currentPageChanging(newPage, oldValue))
+            if (!this.isShowingPreview && !this.currentSingleQuestion && !this.currentPageChanging(newPage, oldValue))
                 return;
             this.setPropertyValue("currentPage", newPage);
             if (!!newPage) {
@@ -42301,6 +42376,8 @@ var survey_SurveyModel = /** @class */ (function (_super) {
     SurveyModel.prototype.performValidationOnPageChanging = function (page) {
         if (this.isDesignMode)
             return false;
+        if (this.canGoTroughValidation())
+            return true;
         var index = this.visiblePages.indexOf(page);
         if (index < 0 || index >= this.visiblePageCount)
             return false;
@@ -42664,20 +42741,22 @@ var survey_SurveyModel = /** @class */ (function (_super) {
             return;
         page.updateCustomWidgets();
     };
-    SurveyModel.prototype.currentPageChanging = function (newValue, oldValue) {
-        var options = this.createPageChangeEventOptions(newValue, oldValue);
+    SurveyModel.prototype.currentPageChanging = function (newValue, oldValue, newQuestion, oldQuestion) {
+        var options = this.createPageChangeEventOptions(newValue, oldValue, newQuestion, oldQuestion);
+        return this.currentPageChangingFromOptions(options);
+    };
+    SurveyModel.prototype.currentPageChangingFromOptions = function (options) {
         options.allow = true;
         options.allowChanging = true;
         this.onCurrentPageChanging.fire(this, options);
         var allow = options.allowChanging && options.allow;
-        if (allow) {
+        if (allow && options.newCurrentPage !== options.oldCurrentPage) {
             this.isCurrentPageRendering = true;
         }
         return allow;
     };
     SurveyModel.prototype.currentPageChanged = function (newValue, oldValue) {
         this.notifyQuestionsOnHidingContent(oldValue);
-        var options = this.createPageChangeEventOptions(newValue, oldValue);
         if (oldValue && !oldValue.isDisposed && !oldValue.passed) {
             if (oldValue.validate(false)) {
                 oldValue.passed = true;
@@ -42686,22 +42765,31 @@ var survey_SurveyModel = /** @class */ (function (_super) {
         if (this.isCurrentPageRendered === true) {
             this.isCurrentPageRendered = false;
         }
-        this.onCurrentPageChanged.fire(this, options);
+        if (!this.currentSingleQuestion) {
+            var options = this.createPageChangeEventOptions(newValue, oldValue);
+            this.onCurrentPageChanged.fire(this, options);
+        }
     };
     SurveyModel.prototype.notifyQuestionsOnHidingContent = function (page) {
         if (page && !page.isDisposed) {
             page.questions.forEach(function (q) { return q.onHidingContent(); });
         }
     };
-    SurveyModel.prototype.createPageChangeEventOptions = function (newValue, oldValue) {
+    SurveyModel.prototype.createPageChangeEventOptions = function (newValue, oldValue, newQuestion, oldQuestion) {
         var diff = !!newValue && !!oldValue ? newValue.visibleIndex - oldValue.visibleIndex : 0;
+        var qDiff = diff;
+        if (qDiff === 0 && !!oldQuestion && !!newQuestion) {
+            qDiff = newValue.elements.indexOf(newQuestion) - newValue.elements.indexOf(oldQuestion);
+        }
         return {
+            oldCurrentQuestion: oldQuestion,
+            newCurrentQuestion: newQuestion,
             oldCurrentPage: oldValue,
             newCurrentPage: newValue,
             isNextPage: diff === 1,
             isPrevPage: diff === -1,
-            isGoingForward: diff > 0,
-            isGoingBackward: diff < 0,
+            isGoingForward: qDiff > 0,
+            isGoingBackward: qDiff < 0,
             isAfterPreview: this.changeCurrentPageFromPreview === true
         };
     };
@@ -42924,6 +43012,8 @@ var survey_SurveyModel = /** @class */ (function (_super) {
      * @see completeLastPage
      */
     SurveyModel.prototype.nextPage = function () {
+        if (this.currentSingleQuestion)
+            return this.performNext();
         if (this.isLastPage)
             return false;
         return this.doCurrentPageComplete(false);
@@ -42954,7 +43044,7 @@ var survey_SurveyModel = /** @class */ (function (_super) {
     };
     SurveyModel.prototype.hasErrorsOnNavigate = function (doComplete) {
         var _this = this;
-        if (!this.isEditMode || this.ignoreValidation)
+        if (this.canGoTroughValidation())
             return false;
         var skipValidation = doComplete && this.validationAllowComplete || !doComplete && this.validationAllowSwitchPages;
         var func = function (hasErrors) {
@@ -42969,6 +43059,7 @@ var survey_SurveyModel = /** @class */ (function (_super) {
         }
         return this.validateCurrentPage(func) !== true && !skipValidation;
     };
+    SurveyModel.prototype.canGoTroughValidation = function () { return !this.isEditMode || !this.validationEnabled; };
     SurveyModel.prototype.checkForAsyncQuestionValidation = function (questions, func) {
         var _this = this;
         this.clearAsyncValidationQuesitons();
@@ -43246,6 +43337,8 @@ var survey_SurveyModel = /** @class */ (function (_super) {
      */
     SurveyModel.prototype.prevPage = function () {
         var _this = this;
+        if (this.currentSingleQuestion)
+            return this.performPrevious();
         if (this.isFirstPage || this.state === "starting")
             return false;
         this.resetNavigationButton();
@@ -43387,7 +43480,7 @@ var survey_SurveyModel = /** @class */ (function (_super) {
          * Possible values:
          *
          * - `"singlePage"` - Combines all survey pages into a single page.
-         * - `"questionPerPage"` - Creates a separate page for every question.
+         * - `"questionPerPage"` - Displays each question on a separate page.
          * - `"standard"` (default) - Retains the original structure specified in the JSON schema.
          */
         get: function () {
@@ -43527,7 +43620,11 @@ var survey_SurveyModel = /** @class */ (function (_super) {
     Object.defineProperty(SurveyModel.prototype, "currentSingleQuestion", {
         get: function () { return this.currentSingleQuestionValue; },
         set: function (val) {
-            if (val !== this.currentSingleQuestion) {
+            var oldVal = this.currentSingleQuestion;
+            if (val !== oldVal) {
+                var options = !!val && !!oldVal ? this.createPageChangeEventOptions(val.page, oldVal.page, val, oldVal) : undefined;
+                if (!!options && !this.currentPageChangingFromOptions(options))
+                    return;
                 this.currentSingleQuestionValue = val;
                 if (!!val) {
                     var page = val.page;
@@ -43541,6 +43638,9 @@ var survey_SurveyModel = /** @class */ (function (_super) {
                         }
                     }
                     this.updateButtonsVisibility();
+                    if (!!options) {
+                        this.onCurrentPageChanged.fire(this, options);
+                    }
                 }
                 else {
                     this.visiblePages.forEach(function (page) { return page.updateRows(); });
@@ -44259,7 +44359,7 @@ var survey_SurveyModel = /** @class */ (function (_super) {
             return;
         var id = question.inputId;
         var root = settings.environment.root;
-        if (!!id && htmlElement.id !== id && typeof root !== "undefined") {
+        if (!!id && (!htmlElement || htmlElement.id !== id) && typeof root !== "undefined") {
             var el = root.getElementById(id);
             if (!!el) {
                 htmlElement = el;
@@ -44411,7 +44511,7 @@ var survey_SurveyModel = /** @class */ (function (_super) {
         return options.error ? new CustomError(options.error, this) : null;
     };
     SurveyModel.prototype.dynamicPanelAdded = function (question, panelIndex, panel) {
-        if (!this.isLoadingFromJson && this.hasQuestionVisibleIndeces(question, true)) {
+        if (!this.isLoadingFromJson && this.hasQuestionVisibleIndeces(question)) {
             this.updateVisibleIndexes(question.page);
         }
         if (this.onDynamicPanelAdded.isEmpty)
@@ -44428,7 +44528,7 @@ var survey_SurveyModel = /** @class */ (function (_super) {
         for (var i = 0; i < questions.length; i++) {
             questions[i].clearOnDeletingContainer();
         }
-        if (this.hasQuestionVisibleIndeces(question, false)) {
+        if (this.hasQuestionVisibleIndeces(question)) {
             this.updateVisibleIndexes(question.page);
         }
         this.onDynamicPanelRemoved.fire(this, {
@@ -44437,10 +44537,7 @@ var survey_SurveyModel = /** @class */ (function (_super) {
             panel: panel,
         });
     };
-    SurveyModel.prototype.hasQuestionVisibleIndeces = function (question, checkIndex) {
-        if (checkIndex) {
-            question.setVisibleIndex(this.getStartVisibleIndex());
-        }
+    SurveyModel.prototype.hasQuestionVisibleIndeces = function (question) {
         var qList = question.getNestedQuestions(true);
         for (var i = 0; i < qList.length; i++) {
             if (qList[i].visibleIndex > -1)
@@ -44460,9 +44557,11 @@ var survey_SurveyModel = /** @class */ (function (_super) {
     };
     SurveyModel.prototype.dynamicPanelItemValueChanged = function (question, options) {
         options.question = question;
-        options.panelIndex = options.itemIndex;
-        options.panelData = options.itemValue;
-        this.onDynamicPanelItemValueChanged.fire(this, options);
+        this.onDynamicPanelValueChanged.fire(this, options);
+    };
+    SurveyModel.prototype.dynamicPanelItemValueChanging = function (question, options) {
+        options.question = question;
+        this.onDynamicPanelValueChanging.fire(this, options);
     };
     SurveyModel.prototype.dynamicPanelGetTabTitle = function (question, options) {
         options.question = question;
@@ -49365,6 +49464,7 @@ var question_baseselect_QuestionSelectBase = /** @class */ (function (_super) {
         var chQuestion = this.choicesFromQuestion;
         if (!!name && chQuestion && (name === chQuestion || questionName === chQuestion)) {
             this.onVisibleChoicesChanged();
+            this.clearIncorrectValues();
         }
     };
     QuestionSelectBase.prototype.updateValueFromSurvey = function (newValue, clearData) {
@@ -55179,6 +55279,9 @@ var question_multipletext_QuestionMultipleTextModel = /** @class */ (function (_
     QuestionMultipleTextModel.prototype.onSurveyLoad = function () {
         this.editorsOnSurveyLoad();
         _super.prototype.onSurveyLoad.call(this);
+        if (!helpers_Helpers.isValueEmpty(this.rows)) {
+            this.calcVisibleRows();
+        }
     };
     QuestionMultipleTextModel.prototype.setQuestionValue = function (newValue, updateIsAnswered) {
         if (updateIsAnswered === void 0) { updateIsAnswered = true; }
@@ -67504,6 +67607,7 @@ var question_paneldynamic_QuestionPanelDynamicModel = /** @class */ (function (_
         }
         if (!qValue[index])
             qValue[index] = {};
+        var oldVal = qValue[index][name];
         if (!this.isValueEmpty(val)) {
             qValue[index][name] = val;
         }
@@ -67513,17 +67617,20 @@ var question_paneldynamic_QuestionPanelDynamicModel = /** @class */ (function (_
         if (index >= 0 && index < this.panelsCore.length) {
             this.changingValueQuestion = this.panelsCore[index].getQuestionByValueName(name);
         }
+        var options = {
+            panel: item.panel,
+            name: name,
+            panelIndex: index,
+            panelData: qValue[index],
+            value: val,
+            oldValue: oldVal
+        };
+        if (this.survey) {
+            this.survey.dynamicPanelItemValueChanging(this, options);
+        }
         this.value = qValue;
         this.changingValueQuestion = null;
         if (this.survey) {
-            var options = {
-                question: this,
-                panel: item.panel,
-                name: name,
-                itemIndex: index,
-                itemValue: qValue[index],
-                value: val,
-            };
             this.survey.dynamicPanelItemValueChanged(this, options);
         }
         this.isSetPanelItemData[name]--;
@@ -67991,21 +68098,10 @@ Serializer.addClass("paneldynamic", [
         default: "off",
         choices: ["off", "onPanel", "onSurvey"],
     },
-    {
-        name: "showRangeInProgress:boolean",
-        default: true,
-        visible: false
-        // visibleIf: (obj: any) => { return obj.displayMode !== "list"; }
-    },
-    {
-        name: "renderMode",
-        default: "list",
-        choices: ["list", "progressTop", "progressBottom", "progressTopBottom", "tab"],
-        visible: false,
-    },
+    { name: "renderMode", visible: false, isSerializable: false },
     { name: "displayMode", default: "list", choices: ["list", "carousel", "tab"] },
     {
-        name: "showProgressBar:boolean",
+        name: "showProgressBar:boolean", alternativeName: "showRangeInProgress",
         default: true,
         visibleIf: function (obj) { return obj.displayMode === "carousel"; }
     },
@@ -70908,9 +71004,9 @@ Serializer.addClass("currencymask", [
 
 var Version;
 var ReleaseDate;
-Version = "" + "1.12.20";
+Version = "" + "1.12.22";
 settings.version = Version;
-ReleaseDate = "" + "2025-01-21";
+ReleaseDate = "" + "2025-02-05";
 function checkLibraryVersion(ver, libraryName) {
     if (Version != ver) {
         var str = "survey-core has version '" + Version + "' and " + libraryName