survey-react 1.12.21 → 1.12.23

package/modern.css

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - Survey JavaScript library v1.12.21
+ * surveyjs - Survey JavaScript library v1.12.23
  * 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.21
+ * surveyjs - Survey JavaScript library v1.12.23
  * 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.21",
+  "version": "1.12.23",
   "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.21
+ * surveyjs - Survey JavaScript library v1.12.23
  * 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.21
+ * surveyjs - Survey JavaScript library v1.12.23
  * 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

@@ -1723,6 +1723,8 @@ declare module "packages/survey-core/src/defaultCss/defaultV2Css" {
             progressBtnIcon: string;
             noEntriesPlaceholder: string;
             compact: string;
+            tabsContainer: string;
+            tabsContainerWithHeader: string;
             tabsRoot: string;
             tabsLeft: string;
             tabsRight: string;
@@ -2719,10 +2721,13 @@ declare module "packages/survey-core/src/textPreProcessor" {
         private get hasAllValuesOnLastRunValue();
         private set hasAllValuesOnLastRunValue(value);
         onProcess: (textValue: TextPreProcessorValue) => void;
-        process(text: string, returnDisplayValue?: boolean, doEncoding?: boolean): string;
+        process(text: string, returnDisplayValue?: boolean, doEncoding?: boolean, replaceUndefinedValues?: boolean): string;
         processValue(name: string, returnDisplayValue: boolean): TextPreProcessorValue;
         get hasAllValuesOnLastRun(): boolean;
+        processText(text: string, returnDisplayValue: boolean): string;
+        processTextEx(params: ITextProcessorProp): ITextProcessorResult;
         private getItems;
+        private isValidItemName;
         private getName;
     }
     export class QuestionTextProcessor implements ITextProcessor {
@@ -2740,7 +2745,7 @@ declare module "packages/survey-core/src/textPreProcessor" {
         private getProcessedTextValue;
         processText(text: string, returnDisplayValue: boolean): string;
         processTextEx(params: ITextProcessorProp): ITextProcessorResult;
-        private processTextCore;
+        private addTextPreProcessor;
     }
 }
 declare module "packages/survey-core/src/error" {
@@ -3263,6 +3268,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 +3477,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 +3614,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
@@ -6595,7 +6604,7 @@ declare module "packages/survey-core/src/question_paneldynamic" {
     import { PanelModel } from "packages/survey-core/src/panel";
     import { SurveyError } from "packages/survey-core/src/survey-error";
     import { ActionContainer } from "packages/survey-core/src/actions/container";
-    import { IAction } from "packages/survey-core/src/actions/action";
+    import { Action, IAction } from "packages/survey-core/src/actions/action";
     import { AdaptiveActionContainer } from "packages/survey-core/src/actions/adaptive-container";
     import { ITheme } from "packages/survey-core/src/themes";
     import { AnimationProperty, IAnimationGroupConsumer } from "packages/survey-core/src/utils/animation";
@@ -6608,6 +6617,13 @@ declare module "packages/survey-core/src/question_paneldynamic" {
         getSurvey(): ISurvey;
         getRootData(): ISurveyData;
     }
+    interface IPanelDynamicTabbedMenuItem extends IAction {
+        panelId: string;
+    }
+    class PanelDynamicTabbedMenuItem extends Action {
+        panelId: string;
+        constructor(innerItem: IPanelDynamicTabbedMenuItem);
+    }
     export class QuestionPanelDynamicItem implements ISurveyData, ISurveyImpl {
         static ItemVariableName: string;
         static ParentItemVariableName: string;
@@ -7063,7 +7079,6 @@ declare module "packages/survey-core/src/question_paneldynamic" {
         set tabAlign(val: "center" | "left" | "right");
         get isRenderModeList(): boolean;
         get isRenderModeTab(): boolean;
-        get hasTitleOnLeftTop(): boolean;
         setVisibleIndex(value: number): number;
         private setPanelVisibleIndex;
         /**
@@ -7237,6 +7252,7 @@ declare module "packages/survey-core/src/question_paneldynamic" {
         get progress(): string;
         getRootCss(): string;
         get cssHeader(): string;
+        getTabsContainerCss(): string;
         getPanelWrapperCss(panel: PanelModel): string;
         getPanelRemoveButtonCss(): string;
         getAddButtonCss(): string;
@@ -7250,9 +7266,9 @@ declare module "packages/survey-core/src/question_paneldynamic" {
         get locNoEntriesText(): LocalizableString;
         getShowNoEntriesPlaceholder(): boolean;
         needResponsiveWidth(): boolean;
-        private additionalTitleToolbarValue;
-        get hasAdditionalTitleToolbar(): boolean;
-        protected getAdditionalTitleToolbar(): AdaptiveActionContainer | null;
+        private tabbedMenuValue;
+        get hasTabbedMenu(): boolean;
+        get tabbedMenu(): AdaptiveActionContainer<PanelDynamicTabbedMenuItem> | null;
         private footerToolbarValue;
         get footerToolbar(): ActionContainer;
         legacyNavigation: boolean;
@@ -7260,7 +7276,7 @@ declare module "packages/survey-core/src/question_paneldynamic" {
         private updateFooterActions;
         private initFooterToolbar;
         private createTabByPanel;
-        private getAdditionalTitleToolbarCss;
+        private getTabbedMenuCss;
         private updateTabToolbarItemsPressedState;
         private updateTabToolbar;
         private addTabFromToolbar;
@@ -7607,7 +7623,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 +7639,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 {
         /**
@@ -8328,10 +8355,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 +8363,10 @@ 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 {
         /**
@@ -9790,7 +9817,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";
@@ -10441,14 +10468,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 after an item value is changing in a panel within a [Dynamic Panel](https://surveyjs.io/form-library/examples/questiontype-paneldynamic/) question.
+         * 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, DynamicPanelItemValueChangedEvent>;
+        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.
          *
@@ -11680,7 +11710,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;
@@ -11775,6 +11806,7 @@ declare module "packages/survey-core/src/survey" {
         performNext(): boolean;
         performPrevious(): boolean;
         private hasErrorsOnNavigate;
+        private canGoTroughValidation;
         private asyncValidationQuesitons;
         private checkForAsyncQuestionValidation;
         private clearAsyncValidationQuesitons;
@@ -11888,7 +11920,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;
@@ -15090,6 +15122,7 @@ declare module "packages/survey-core/src/base-interfaces" {
         returnDisplayValue?: boolean;
         doEncoding?: boolean;
         runAtDesign?: boolean;
+        replaceUndefinedValues?: boolean;
     }
     export interface ITextProcessorResult {
         text: string;
@@ -15834,7 +15867,7 @@ declare module "packages/survey-core/src/localizablestring" {
         set localizationName(val: string);
         private _allowLineBreaks;
         get allowLineBreaks(): boolean;
-        onGetTextCallback: (str: string) => string;
+        onGetTextCallback: (str: string, nonProcessedText?: string) => string;
         storeDefaultText: boolean;
         serializeCallBackText: boolean;
         onGetLocalizationTextCallback: (str: string) => string;