survey-react 1.12.20 → 1.12.22

package/defaultV2.css

@@ -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)
  */

package/defaultV2.min.css

@@ -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)
  */

package/modern.css

@@ -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)
  */

package/modern.min.css

@@ -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)
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "survey-react",
-  "version": "1.12.20",
+  "version": "1.12.22",
   "description": "survey.js is a JavaScript Survey Library. It is a modern way to add a survey to your website. It uses JSON for survey metadata and results.",
   "keywords": [
     "Survey",

package/survey.css

@@ -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)
  */

package/survey.min.css

@@ -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)
  */

package/survey.react.d.ts

@@ -2723,6 +2723,7 @@ declare module "packages/survey-core/src/textPreProcessor" {
         processValue(name: string, returnDisplayValue: boolean): TextPreProcessorValue;
         get hasAllValuesOnLastRun(): boolean;
         private getItems;
+        private isValidItemName;
         private getName;
     }
     export class QuestionTextProcessor implements ITextProcessor {
@@ -3263,6 +3264,9 @@ declare module "packages/survey-core/src/question_custom" {
         protected getQuestionByName(name: string): IQuestion;
         private settingNewValue;
         setValue(name: string, newValue: any, locNotification: any, allowNotifyValueChanged?: boolean): any;
+        setComment(name: string, newValue: string, locNotification: any): any;
+        getComment(name: string): string;
+        private getCommentName;
         private runPanelTriggers;
         getFilteredValues(): any;
         private updateValueCoreWithPanelValue;
@@ -3469,7 +3473,7 @@ declare module "packages/survey-core/src/panel" {
         set questionsOrder(val: string);
         private canRandomize;
         protected isRandomizing: boolean;
-        randomizeElements(isRandom: boolean): void;
+        randomizeElements(isRandom: boolean): boolean;
         /**
          * Returns `true` if elements in this panel/page are arranged in random order.
          * @see questionsOrder
@@ -3606,6 +3610,7 @@ declare module "packages/survey-core/src/panel" {
         protected getContainsErrors(): boolean;
         updateElementVisibility(): void;
         getFirstQuestionToFocus(withError?: boolean, ignoreCollapseState?: boolean): Question;
+        getFirstVisibleQuestion(): Question;
         /**
          * Focuses the first question in this panel/page.
          * @see focusFirstErrorQuestion
@@ -7607,7 +7612,7 @@ declare module "packages/survey-core/src/survey-events-api" {
          */
         isNextPage: boolean;
         /**
-         * Returns `true` if the respondent is going backward, that is, `newCurrentPage` is earlier in the survey than `oldCurrentPage`.
+         * Returns `true` if the respondent is going backward, that is, `newCurrentPage` or `newCurrentQuestion` is earlier in the survey than `oldCurrentPage`  or `oldCurrentQuestion`.
          */
         isGoingBackward: boolean;
         /**
@@ -7623,9 +7628,20 @@ declare module "packages/survey-core/src/survey-events-api" {
          */
         newCurrentPage: PageModel;
         /**
-         * A page that used to be current.
+         * A page that used to be current.\
+         * In [question-per-page mode](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#questionsOnPageMode), the `oldCurrentPage` and `newCurrentPage` parameters may contain the same `PageModel` instance. This is because the survey doesn't create artificial pages to display only one question per page. If both the previous and current questions belong to the same page in the survey JSON schema, they have the same parent `PageModel` instance.
          */
         oldCurrentPage: PageModel;
+        /**
+         * The current question.\
+         * This parameter has a value only in [question-per-page mode](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#questionsOnPageMode).
+         */
+        oldCurrentQuestion?: Question;
+        /**
+         * A question that used to be current.\
+         * This parameter has a value only in [question-per-page mode](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#questionsOnPageMode).
+         */
+        newCurrentQuestion?: Question;
     }
     export interface CurrentPageChangingEvent extends CurrentPageChangedEvent {
         /**
@@ -8317,7 +8333,7 @@ declare module "packages/survey-core/src/survey-events-api" {
          */
         text: string;
     }
-    export interface DynamicPanelItemValueChangedEvent extends PanelDynamicQuestionEventMixin {
+    export interface DynamicPanelValueChangedEvent extends PanelDynamicQuestionEventMixin {
         /**
          * The panel's data object that includes all item values.
          */
@@ -8328,10 +8344,6 @@ declare module "packages/survey-core/src/survey-events-api" {
          * The panel's index within Dynamic Panel.
          */
         panelIndex: number;
-        /**
-         * The item's new value.
-         */
-        value: any;
         /**
          * The item's name.
          */
@@ -8340,6 +8352,18 @@ declare module "packages/survey-core/src/survey-events-api" {
          * A panel that nests the item with a changed value.
          */
         panel: PanelModel;
+        /**
+         * The item's new value.
+         */
+        value: any;
+    }
+    export interface DynamicPanelValueChangingEvent extends DynamicPanelValueChangedEvent {
+        /**
+         * The item's old value.
+         */
+        oldValue: any;
+    }
+    export interface DynamicPanelItemValueChangedEvent extends DynamicPanelValueChangedEvent {
     }
     export interface DynamicPanelCurrentIndexChangedEvent extends PanelDynamicQuestionEventMixin {
         /**
@@ -9782,7 +9806,7 @@ declare module "packages/survey-core/src/survey" {
     import { ActionContainer } from "packages/survey-core/src/actions/container";
     import { QuestionPanelDynamicModel } from "packages/survey-core/src/question_paneldynamic";
     import { Notifier } from "packages/survey-core/src/notifier";
-    import { TriggerExecutedEvent, CompletingEvent, CompleteEvent, ShowingPreviewEvent, NavigateToUrlEvent, CurrentPageChangingEvent, CurrentPageChangedEvent, ValueChangingEvent, ValueChangedEvent, VariableChangedEvent, QuestionVisibleChangedEvent, PageVisibleChangedEvent, PanelVisibleChangedEvent, QuestionCreatedEvent, QuestionAddedEvent, QuestionRemovedEvent, PanelAddedEvent, PanelRemovedEvent, PageAddedEvent, ValidateQuestionEvent, SettingQuestionErrorsEvent, ValidatePanelEvent, ErrorCustomTextEvent, ValidatedErrorsOnCurrentPageEvent, ProcessHtmlEvent, GetQuestionTitleEvent, GetTitleTagNameEvent, GetQuestionNumberEvent, GetPageNumberEvent, GetPanelNumberEvent, GetProgressTextEvent, TextMarkdownEvent, SendResultEvent, GetResultEvent, UploadFilesEvent, DownloadFileEvent, ClearFilesEvent, LoadChoicesFromServerEvent, ProcessTextValueEvent, UpdateQuestionCssClassesEvent, UpdatePanelCssClassesEvent, UpdatePageCssClassesEvent, UpdateChoiceItemCssEvent, AfterRenderSurveyEvent, AfterRenderPageEvent, AfterRenderQuestionEvent, AfterRenderQuestionInputEvent, AfterRenderPanelEvent, FocusInQuestionEvent, FocusInPanelEvent, ShowingChoiceItemEvent, ChoicesLazyLoadEvent, GetChoiceDisplayValueEvent, MatrixRowAddedEvent, MatrixBeforeRowAddedEvent, MatrixRowRemovingEvent, MatrixRowRemovedEvent, MatrixAllowRemoveRowEvent, MatrixDetailPanelVisibleChangedEvent, MatrixCellCreatingEvent, MatrixCellCreatedEvent, MatrixAfterCellRenderEvent, MatrixCellValueChangedEvent, MatrixCellValueChangingEvent, MatrixCellValidateEvent, DynamicPanelModifiedEvent, DynamicPanelRemovingEvent, DynamicPanelItemValueChangedEvent, DynamicPanelGetTabTitleEvent, DynamicPanelCurrentIndexChangedEvent, CheckAnswerCorrectEvent, DragDropAllowEvent, ScrollToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent, ChoicesSearchEvent, OpenFileChooserEvent, OpenDropdownMenuEvent, ResizeEvent, ProgressTextEvent, ScrollingElementToTopEvent, IsAnswerCorrectEvent } from "packages/survey-core/src/survey-events-api";
+    import { TriggerExecutedEvent, CompletingEvent, CompleteEvent, ShowingPreviewEvent, NavigateToUrlEvent, CurrentPageChangingEvent, CurrentPageChangedEvent, ValueChangingEvent, ValueChangedEvent, VariableChangedEvent, QuestionVisibleChangedEvent, PageVisibleChangedEvent, PanelVisibleChangedEvent, QuestionCreatedEvent, QuestionAddedEvent, QuestionRemovedEvent, PanelAddedEvent, PanelRemovedEvent, PageAddedEvent, ValidateQuestionEvent, SettingQuestionErrorsEvent, ValidatePanelEvent, ErrorCustomTextEvent, ValidatedErrorsOnCurrentPageEvent, ProcessHtmlEvent, GetQuestionTitleEvent, GetTitleTagNameEvent, GetQuestionNumberEvent, GetPageNumberEvent, GetPanelNumberEvent, GetProgressTextEvent, TextMarkdownEvent, SendResultEvent, GetResultEvent, UploadFilesEvent, DownloadFileEvent, ClearFilesEvent, LoadChoicesFromServerEvent, ProcessTextValueEvent, UpdateQuestionCssClassesEvent, UpdatePanelCssClassesEvent, UpdatePageCssClassesEvent, UpdateChoiceItemCssEvent, AfterRenderSurveyEvent, AfterRenderPageEvent, AfterRenderQuestionEvent, AfterRenderQuestionInputEvent, AfterRenderPanelEvent, FocusInQuestionEvent, FocusInPanelEvent, ShowingChoiceItemEvent, ChoicesLazyLoadEvent, GetChoiceDisplayValueEvent, MatrixRowAddedEvent, MatrixBeforeRowAddedEvent, MatrixRowRemovingEvent, MatrixRowRemovedEvent, MatrixAllowRemoveRowEvent, MatrixDetailPanelVisibleChangedEvent, MatrixCellCreatingEvent, MatrixCellCreatedEvent, MatrixAfterCellRenderEvent, MatrixCellValueChangedEvent, MatrixCellValueChangingEvent, MatrixCellValidateEvent, DynamicPanelModifiedEvent, DynamicPanelRemovingEvent, DynamicPanelItemValueChangedEvent, DynamicPanelValueChangingEvent, DynamicPanelGetTabTitleEvent, DynamicPanelCurrentIndexChangedEvent, CheckAnswerCorrectEvent, DragDropAllowEvent, ScrollToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent, ChoicesSearchEvent, OpenFileChooserEvent, OpenDropdownMenuEvent, ResizeEvent, ProgressTextEvent, ScrollingElementToTopEvent, IsAnswerCorrectEvent } from "packages/survey-core/src/survey-events-api";
     import { QuestionMatrixDropdownModelBase } from "packages/survey-core/src/question_matrixdropdownbase";
     import { QuestionMatrixDynamicModel } from "packages/survey-core/src/question_matrixdynamic";
     import { QuestionFileModel } from "packages/survey-core/src/question_file";
@@ -9905,7 +9929,7 @@ declare module "packages/survey-core/src/survey" {
          *
          * 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
          */
         onValueChanged: EventBase<SurveyModel, ValueChangedEvent>;
@@ -10433,9 +10457,17 @@ declare module "packages/survey-core/src/survey" {
         onTimer: EventBase<SurveyModel, {}>;
         onTimerPanelInfoText: EventBase<SurveyModel, any>;
         /**
-         * 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.
+         */
+        onDynamicPanelValueChanged: EventBase<SurveyModel, DynamicPanelItemValueChangedEvent>;
+        /**
+         * @deprecated Use the [`onDynamicPanelValueChanged`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onDynamicPanelValueChanged) event instead.
          */
         onDynamicPanelItemValueChanged: EventBase<SurveyModel, DynamicPanelItemValueChangedEvent>;
+        /**
+         * 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.
+         */
+        onDynamicPanelValueChanging: EventBase<SurveyModel, DynamicPanelValueChangingEvent>;
         /**
          * 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.
          *
@@ -11667,7 +11699,8 @@ declare module "packages/survey-core/src/survey" {
         mergeValues(src: any, dest: any): void;
         private updateValuesWithDefaults;
         protected updateCustomWidgets(page: PageModel): void;
-        protected currentPageChanging(newValue: PageModel, oldValue: PageModel): boolean;
+        protected currentPageChanging(newValue: PageModel, oldValue: PageModel, newQuestion?: Question, oldQuestion?: Question): boolean;
+        private currentPageChangingFromOptions;
         protected currentPageChanged(newValue: PageModel, oldValue: PageModel): void;
         private notifyQuestionsOnHidingContent;
         private createPageChangeEventOptions;
@@ -11762,6 +11795,7 @@ declare module "packages/survey-core/src/survey" {
         performNext(): boolean;
         performPrevious(): boolean;
         private hasErrorsOnNavigate;
+        private canGoTroughValidation;
         private asyncValidationQuesitons;
         private checkForAsyncQuestionValidation;
         private clearAsyncValidationQuesitons;
@@ -11875,7 +11909,7 @@ declare module "packages/survey-core/src/survey" {
          * 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 questionsOnPageMode(): string;
@@ -12085,6 +12119,7 @@ declare module "packages/survey-core/src/survey" {
         private hasQuestionVisibleIndeces;
         dynamicPanelRemoving(question: QuestionPanelDynamicModel, panelIndex: number, panel: PanelModel): boolean;
         dynamicPanelItemValueChanged(question: IQuestion, options: any): void;
+        dynamicPanelItemValueChanging(question: IQuestion, options: any): void;
         dynamicPanelGetTabTitle(question: IQuestion, options: any): void;
         dynamicPanelCurrentIndexChanged(question: IQuestion, options: any): void;
         dragAndDropAllow(options: DragDropAllowEvent): boolean;
@@ -15216,7 +15251,8 @@ declare module "packages/survey-core/src/base-interfaces" {
         dynamicPanelAdded(question: IQuestion, panelIndex?: number, panel?: IPanel): void;
         dynamicPanelRemoved(question: IQuestion, panelIndex: number, panel: IPanel): void;
         dynamicPanelRemoving(question: IQuestion, panelIndex: number, panel: IPanel): boolean;
-        dynamicPanelItemValueChanged(question: IQuestion, options: any): any;
+        dynamicPanelItemValueChanged(question: IQuestion, options: any): void;
+        dynamicPanelItemValueChanging(question: IQuestion, options: any): void;
         dynamicPanelGetTabTitle(question: IQuestion, options: any): any;
         dynamicPanelCurrentIndexChanged(question: IQuestion, options: any): void;
         dragAndDropAllow(options: DragDropAllowEvent): boolean;